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
|
work/ tracked scratch, deleted when the run closes
|
||||||
```
|
```
|
||||||
|
|
||||||
Alongside it, not part of it: `instructions/` (what agents are told to do), `docs/` (why the
|
Alongside it, not part of it: `instructions/` (what agents are told to do), `docs/` (the stack's
|
||||||
stack is built the way it is - see [File naming](#file-naming)), and this file.
|
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:
|
**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
|
**Author:** Torben Nehmer
|
||||||
|
|
||||||
@@ -31,6 +31,7 @@ place only: `instructions/dev/version-parts.md` § The candidate model.
|
|||||||
|
|
||||||
**Low impact**
|
**Low impact**
|
||||||
- version bump: Abschlussmeldung nennt Stichpunkt oder Themenabsatz statt pauschal Prosa
|
- 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 -->
|
<!-- /wikitool:bumps -->
|
||||||
|
|
||||||
### Doku-Gerüst nach Diátaxis unter `docs/` (#187)
|
### 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.
|
recorded reason at all.
|
||||||
|
|
||||||
`docs/` belongs in for the reason the threshold exists. AGENTS.md § File naming
|
`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,
|
calls a page in one of its four areas "Humans and agents ... | By link, or on
|
||||||
at a second hop, which is precisely the preview mechanic
|
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
|
`instructions/CONTRACT.md` § "Reference depth" treats as real. The exclusion of
|
||||||
the human docs (`README.md`, `CHANGES.md`, `EVALS.md`, `INSTALL.md`,
|
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
|
`tools/README.md`) rests on a sentence that does not stretch to cover it: those
|
||||||
|
|||||||
Reference in new issue
Block a user