docs: AGENTS.md routing line and toc.py docstring describe docs/ as the whole human documentation (#187)
CI / verify (push) Successful in 6m7s
CI / pwsh (push) Successful in 2m1s
Release / release (push) Successful in 34s

Closing-phase pull-through: both still described docs/ by its pre-9.0.0 role.

Files changed:
- AGENTS.md
- CHANGES.md
- VERSION
- tools/chemenu/toc.py

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SnAJ7Z3CpVD3PRbN73QtU2
This commit is contained in:
torbenandClaude Opus 5.5 committed 2026-10-06 20:58:30 +02:00
1 parent d66a3f65f4
commit 01c888d3cd
4 files changed
+8 -6

No files matched your search

+3 -2
View File
@@ -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:
+2 -1
View File
@@ -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
<!-- /wikitool:bumps -->
### Doku-Gerüst nach Diátaxis unter `docs/` (#187)
+1 -1
View File
@@ -1 +1 @@
9.0.0-beta.1
9.0.0-beta.2
+2 -2
View File
@@ -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