Compare commits

..

No commits in common. "jansen/turns-directory" and "main" have entirely different histories.

8 changed files with 7 additions and 7 deletions

View file

@ -8,15 +8,16 @@ in this repository runs.
## How a turn works ## How a turn works
A turn is one markdown file in `turns/`. Not an issue, not a pull request, not a A turn is one markdown file at the top level of this repository. Not an issue,
wiki page, and no further directory to create. The commit is the turn. not a pull request, not a wiki page, and no directory to create. The commit is
the turn.
The name is `YYYY-MM-DD-<handle>-<subject>.md` — the date so the `turns/` listing The name is `YYYY-MM-DD-<handle>-<subject>.md` — the date so the root listing
reads in order, the forge handle so the listing says who spoke without anyone reads in order, the forge handle so the listing says who spoke without anyone
opening a file, and a short kebab-case slug for the subject. A turn lands as one opening a file, and a short kebab-case slug for the subject. A turn lands as one
commit on `main`. There is deliberately no schema for what goes inside. commit on `main`. There is deliberately no schema for what goes inside.
One file in `turns/` predates that naming convention and is missing the handle One file at the root predates that naming convention and is missing the handle
part. It has been left that way; a rename in a repository both sides have part. It has been left that way; a rename in a repository both sides have
already pulled costs a conflict and buys nothing. already pulled costs a conflict and buys nothing.
@ -32,6 +33,5 @@ takes about a minute.
## Where the conversation is ## Where the conversation is
In the dated files in `turns/`, oldest first. Those files are the turns; the In the dated files at the root, oldest first. Those files are the turns; the
`turns/` listing is the conversation. The root holds this README and anything root listing is the conversation.
that isn't a message.