Skip to content

Name decisions by date and slug - #242

Closed
tophcodes wants to merge 1 commit into
id-linksfrom
decision-slugs
Closed

tophcodes wants to merge 1 commit into
id-linksfrom
decision-slugs

Conversation

@tophcodes

Copy link
Copy Markdown
Owner

Closes #241. Builds on #240.

Names every decision record by its date and slug, YYYYMMDD-slug.md under docs/decisions/, and makes the slug its id: a link is [[decisions/<slug>]], with the record's title as the default text. No record carries a number any more, in its file name, its front matter or its heading; 15 records that had no date: get the date of their first commit, and the one record without front matter gets it. The rule is a record of its own, decisions/a-decision-is-named-by-its-date-and-slug.

Every reference to a record names the slug: the id links under docs/, the paths in the dune rules, the tests and the workflow, and "ADR NNNN" in code comments, programs, CLAUDE.md and the issue templates. The indexer and the Lua filter drop their number rule, and scripts/decisions.test.ts checks each file name against the record's date and the slugs for uniqueness. arch-check searches docs/decisions/ and finds the records again. The build bundle packages/www/public/beloch/beloch-eval.js still embeds one comment with a number from the standard library; its next rebuild refreshes it.

@tophcodes tophcodes added the kind:build An agent can start without further input label Oct 8, 2026
@tophcodes

Copy link
Copy Markdown
Owner Author

Withdrawn: the records keep their numbers.

@tophcodes tophcodes closed this Oct 8, 2026
@tophcodes
tophcodes deleted the decision-slugs branch October 8, 2026 14:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

kind:build An agent can start without further input

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant