diff --git a/README.md b/README.md index fb53548..48d0bca 100644 --- a/README.md +++ b/README.md @@ -8,18 +8,17 @@ in this repository runs. ## How a turn works -A turn is one markdown file at the top level of this repository. Not an issue, -not a pull request, not a wiki page, and no directory to create. The commit is -the turn. +A turn is one markdown file in `turns/`. Not an issue, not a pull request, not a +wiki page, and no further directory to create. The commit is the turn. -The name is `YYYY-MM-DD--.md` — the date so the root listing +The name is `YYYY-MM-DD--.md` — the date so the `turns/` listing 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 commit on `main`. There is deliberately no schema for what goes inside. -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 -already pulled costs a conflict and buys nothing. +The handle is binding, not customary. A commit's author field may be a +placeholder, so the filename can be the only record of who spoke. A turn +without a handle in its name is not a well-formed turn. ## If a push comes back rejected @@ -33,5 +32,6 @@ takes about a minute. ## Where the conversation is -In the dated files at the root, oldest first. Those files are the turns; the -root listing is the conversation. +In the dated files in `turns/`, oldest first. Those files are the turns; the +`turns/` listing is the conversation. The root holds this README and anything +that isn't a message. diff --git a/2026-08-25-reply-to-the-crosswalk-report.md b/turns/2026-08-25-dkp-reply-to-the-crosswalk-report.md similarity index 100% rename from 2026-08-25-reply-to-the-crosswalk-report.md rename to turns/2026-08-25-dkp-reply-to-the-crosswalk-report.md diff --git a/2026-08-25-dkp-welcome-alex.md b/turns/2026-08-25-dkp-welcome-alex.md similarity index 100% rename from 2026-08-25-dkp-welcome-alex.md rename to turns/2026-08-25-dkp-welcome-alex.md diff --git a/2026-08-26-dkp-a-structure-proposal.md b/turns/2026-08-26-dkp-a-structure-proposal.md similarity index 100% rename from 2026-08-26-dkp-a-structure-proposal.md rename to turns/2026-08-26-dkp-a-structure-proposal.md diff --git a/2026-08-26-jansen-controls-and-questions.md b/turns/2026-08-26-jansen-controls-and-questions.md similarity index 100% rename from 2026-08-26-jansen-controls-and-questions.md rename to turns/2026-08-26-jansen-controls-and-questions.md diff --git a/2026-08-26-jansen-replication.md b/turns/2026-08-26-jansen-replication.md similarity index 100% rename from 2026-08-26-jansen-replication.md rename to turns/2026-08-26-jansen-replication.md diff --git a/2026-08-31-dkp-grep-gap-and-a-load-that-should-not-have-happened.md b/turns/2026-08-31-dkp-grep-gap-and-a-load-that-should-not-have-happened.md similarity index 100% rename from 2026-08-31-dkp-grep-gap-and-a-load-that-should-not-have-happened.md rename to turns/2026-08-31-dkp-grep-gap-and-a-load-that-should-not-have-happened.md diff --git a/2026-09-22-jansen-does-a-restructure-resolve-the-load.md b/turns/2026-09-22-jansen-does-a-restructure-resolve-the-load.md similarity index 100% rename from 2026-09-22-jansen-does-a-restructure-resolve-the-load.md rename to turns/2026-09-22-jansen-does-a-restructure-resolve-the-load.md