diff --git a/AGENTS.md b/AGENTS.md index f62a219..9a740f9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -222,8 +222,9 @@ input schema + compiler output derived (gitignored) work/ tracked scratch, deleted when the run closes ``` -Alongside it, not part of it: `instructions/` (what agents are told to do), `docs/` (why the -stack is built the way it is - see [File naming](#file-naming)), and this file. +Alongside it, not part of it: `instructions/` (what agents are told to do), `docs/` (the stack's +human documentation, including why it is built the way it is - see [File naming](#file-naming)), +and this file. **By stage** - read the contract for the stage you are writing in: diff --git a/CHANGES.md b/CHANGES.md index 19a2990..8e1c48b 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -14,7 +14,7 @@ place only: `instructions/dev/version-parts.md` § The candidate model. --- -## 9.0.0-beta.1 - 2026-10-06 - docs/ sorted into tutorials, how-to, reference and explanation plus an unshipped docs/dev/; explanation pages moved, developer guide moved and translated, human docs English +## 9.0.0-beta.2 - 2026-10-06 - AGENTS.md routing line and a toc.py docstring describe docs/ as the whole human documentation **Author:** Torben Nehmer @@ -31,6 +31,7 @@ place only: `instructions/dev/version-parts.md` § The candidate model. **Low impact** - version bump: Abschlussmeldung nennt Stichpunkt oder Themenabsatz statt pauschal Prosa +- AGENTS.md routing line and a toc.py docstring describe docs/ as the whole human documentation ### Doku-Gerüst nach Diátaxis unter `docs/` (#187) diff --git a/VERSION b/VERSION index 93bdcf1..fb87088 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -9.0.0-beta.1 +9.0.0-beta.2 diff --git a/tools/chemenu/toc.py b/tools/chemenu/toc.py index e6e019b..40de98f 100644 --- a/tools/chemenu/toc.py +++ b/tools/chemenu/toc.py @@ -31,8 +31,8 @@ decision, and did: `docs/` and the page type-specs sat outside it for no recorded reason at all. `docs/` belongs in for the reason the threshold exists. AGENTS.md § File naming -calls it "Agents and humans | By link, or on explicit request" - agent-loaded, -at a second hop, which is precisely the preview mechanic +calls a page in one of its four areas "Humans and agents ... | By link, or on +explicit request" - agent-loaded, at a second hop, which is precisely the preview mechanic `instructions/CONTRACT.md` § "Reference depth" treats as real. The exclusion of the human docs (`README.md`, `CHANGES.md`, `EVALS.md`, `INSTALL.md`, `tools/README.md`) rests on a sentence that does not stretch to cover it: those