feat!: docs/ sorted into tutorials, how-to, reference, explanation plus unshipped docs/dev/; explanation pages and developer guide moved, human docs English (#187)
The seven explanation pages move to docs/explanation/ without a stub, DEVELOPMENT.md becomes docs/dev/development.md (translated to English), dist export leaves docs/dev/ out, docs verify rejects a file outside the five areas, and AGENTS.md states that the stack's human documentation is English. Required migration 9.0.0-docs-diataxis rewrites the old path in an instance's own kb/CONVENTIONS.md. Files changed: - .wikitool-kb.json - AGENTS.md - CHANGES.md - CLAUDE.md - DEVELOPMENT.md - INSTALL.md - README.md - VERSION - docs/dev/development.md - docs/explanation/README.md - docs/explanation/knowledge-and-commitment.md - docs/explanation/language-boundaries.md - docs/explanation/model-and-effort-selection.md - docs/explanation/ownership-and-templates.md - docs/explanation/pipeline-rationale.md - docs/explanation/version-model.md - docs/explanation/why-gates-are-code.md - docs/how-to/README.md - docs/knowledge-and-commitment.md - docs/language-boundaries.md - docs/model-and-effort-selection.md - docs/ownership-and-templates.md - docs/pipeline-rationale.md - docs/reference/README.md - docs/tutorials/README.md - docs/version-model.md - docs/why-gates-are-code.md - instructions/CONTRACT.md - instructions/dev/dev-setup.md - instructions/dev/doc-pull-through.md - instructions/dev/stack-close/SKILL.md - instructions/dev/stack-mode.md - instructions/gtd-weekly-review/SKILL.md - instructions/ingest-queue.md - instructions/migrations/6.0.0-type-guidance-split.md - instructions/migrations/9.0.0-docs-diataxis.md - instructions/upgrade-instance.md - kb/CONVENTIONS.md - kb/CONVENTIONS.md.template - tools/CONTRACT.md - tools/chemenu/commands/dist_cmd.py - tools/chemenu/commands/docs_verify.py - tools/chemenu/commands/new_page.py - tools/chemenu/commands/task_cmd.py - tools/chemenu/tasks/protocol.py - tools/chemenu/tests/test_dist_cmd.py - tools/chemenu/tests/test_docs_verify.py - tools/chemenu/tests/test_git_publish.py - tools/chemenu/tests/test_toc.py - types/type-guidance.md 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
0e15972ee7
commit
d66a3f65f4
43 files changed
+756
-324
No files matched your search
+18
-1
@@ -14,11 +14,18 @@ place only: `instructions/dev/version-parts.md` § The candidate model.
|
||||
|
||||
---
|
||||
|
||||
## 8.1.0-beta.2 - 2026-10-06 - version bump: Abschlussmeldung nennt Stichpunkt oder Themenabsatz statt pauschal Prosa
|
||||
## 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
|
||||
|
||||
**Author:** Torben Nehmer
|
||||
|
||||
**Breaking Change:** The seven pages that sat directly in docs/ now live in docs/explanation/, with nothing left at the old paths. An instance's own kb/CONVENTIONS.md still links ../docs/language-boundaries.md, so docs verify reports a dead link after the upgrade until the required migration document rewrites the path - step 12 of the upgrade.
|
||||
|
||||
**Migration:** required - instructions/migrations/9.0.0-docs-diataxis.md
|
||||
|
||||
<!-- wikitool:bumps -->
|
||||
**High impact**
|
||||
- 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
|
||||
|
||||
**Medium impact**
|
||||
- Changelog kompakt: ein Absatz pro Thema, Größenbudget, Migrationsverweis
|
||||
|
||||
@@ -26,6 +33,16 @@ place only: `instructions/dev/version-parts.md` § The candidate model.
|
||||
- version bump: Abschlussmeldung nennt Stichpunkt oder Themenabsatz statt pauschal Prosa
|
||||
<!-- /wikitool:bumps -->
|
||||
|
||||
### Doku-Gerüst nach Diátaxis unter `docs/` (#187)
|
||||
|
||||
`docs/` hat vier Bereiche – `tutorials/`, `how-to/`, `reference/`, `explanation/`, je mit einer
|
||||
`README.md` – und `docs/dev/`, das `dist export` wie `instructions/dev/` weglässt. Die sieben
|
||||
Erklärseiten liegen jetzt unter `docs/explanation/`, ohne Stub am alten Ort; `DEVELOPMENT.md` ist
|
||||
als `docs/dev/development.md` englisch. `docs verify` meldet jede Datei, die direkt in `docs/` oder
|
||||
außerhalb der fünf Bereiche liegt. `AGENTS.md` § File naming legt fest, dass die menschliche Doku
|
||||
des Stacks englisch ist, unabhängig von `language:`. Das bestehende `kb/CONVENTIONS.md` einer
|
||||
Instanz verlinkt noch den alten Pfad, deshalb führt das Pflicht-Migrationsdokument ihn nach.
|
||||
|
||||
### Changelog-Einträge mit Größenbudget und Migrationsverweis (#184)
|
||||
|
||||
Ein Eintrag bekommt `###`-Abschnitte pro Thema statt pro Bump; eine kleinere Änderung steht nur
|
||||
|
||||
Reference in new issue
Block a user