docs: AGENTS.md routing line and toc.py docstring describe docs/ as the whole human documentation (#187)
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:
1 parent
d66a3f65f4
commit
01c888d3cd
4 files changed
+8
-6
No files matched your search
@@ -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
@@ -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)
|
||||
|
||||
@@ -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
|
||||
|
||||
Reference in new issue
Block a user