2.1 KiB
title, type, source, date, draft, tags, description
| title | type | source | date | draft | tags | description | ||
|---|---|---|---|---|---|---|---|---|
| How threads are organized | note | original | 2026-08-23 | false |
|
How archived Twitter/X threads are filed and read. |
Threads are grouped by author handle, then by date and a short title.
archive/threads/<handle>/<YYYY-MM-DD-slug>/
index.md ← the author's own chain (the spine)
YYYY-MM-DD-who-slug.md ← one file per reply that left that chain
Spine
index.md is only what the author posted as a single chain: each post replies to the previous one of theirs. Posts are numbered 1/ 2/ in that order. Other people do not appear in this numbering.
If the first post is a reply to someone else, that other tweet is quoted at the top as context. It is not numbered as part of the spine.
Branches
A reply from someone else, or a second chain the author started from an earlier post, is its own note in the same folder. Follow-ups on that reply stay in that note, including if the original author answers there.
The spine links out under the post that grew the branch. Each branch note links back to index.
Cross-author conversations
When a thread alternates between authors (A replies to B replies to A), the archive directory is owned by the OP — the post with no parent in the chain — and the spine walks every post in chronological order regardless of handle. Cross-author posts appear inline in the spine. Responder handles do not get their own directories; the conversation lives in one folder under the OP's name.
Tags
Every imported thread starts with archive, twitter, and the author's handle. Topic tags (vulkan, crt, alsa, …) are added by hand when the thread is reviewed.
Images
Pictures on the site are direct HTTPS URLs from the original image host when possible. Working copies of files live outside what GitHub Pages serves. A note that is still being prepared is marked draft: true and does not appear on the site.
Reading
Start at archive/threads/index, pick a handle, then a date. The spine is the essay. Branch files are the conversation around it.