stack: TOC-Scope auf types/ und docs/, Sprachregeln nach AGENTS.md zentralisiert, alle Templates auf Control-Plane-Sprache, --breaking akkumuliert (schliesst #99)
Files changed: - AGENTS.md - CHANGES.md - ENVIRONMENT.md.template - SOUL.md - SOUL.md.template - USER.md.template - VERSION - docs/ownership-and-templates.md - docs/version-model.md - instructions/CONTRACT.md - instructions/dev/doc-pull-through.md - instructions/dev/stack-close/SKILL.md - instructions/dev/stack-dev/SKILL.md - instructions/dev/version-parts.md - instructions/setup-instance.md - kb/CONVENTIONS.md - kb/CONVENTIONS.md.template - kb/concepts/COLLECTION.md - kb/sources/COLLECTION.md - tools/CONTRACT.md - tools/chemenu/commands/types_cmd.py - tools/chemenu/commands/version_cmd.py - tools/chemenu/tests/test_toc.py - tools/chemenu/tests/test_version_cmd.py - tools/chemenu/toc.py - tools/chemenu/version.py - types/comparison.md - types/concept.md - types/entity.md - types/lint-report.md - types/source.md
This commit is contained in:
+21
-22
@@ -35,32 +35,31 @@ tone, relationship labels, the confidence rubric. Neither is restated here.
|
||||
|
||||
## Types offered
|
||||
|
||||
`concept` (`tools/wikitool types describe concept`). Das Feld `concept_type:`
|
||||
wählt die Area:
|
||||
`concept` (`tools/wikitool types describe concept`). The `concept_type:` field
|
||||
picks the area:
|
||||
|
||||
| Area | Hält |
|
||||
|------|------|
|
||||
| `architectures/` | Aufbau und Struktur: wie ein System geschnitten ist und warum die Schnitte dort liegen |
|
||||
| `patterns/` | Wiederverwendbare Lösungsformen, die über mehr als einen Gegenstand hinweg gelten |
|
||||
| `protocols/` | Kommunikationsprotokolle und Standards, in ihrer üblichen Schreibweise benannt |
|
||||
| `workflows/` | Abläufe und Prozesse, die projektübergreifend wiederkehren |
|
||||
| `decisions/` | Architektur- und Entwurfsentscheidungen (siehe unten) |
|
||||
| `problems/` | Wiederkehrende Problemstellungen und ihre Lösungsansätze |
|
||||
| Area | Holds |
|
||||
|------|-------|
|
||||
| `architectures/` | Shape and structure: how a system is cut up, and why the cuts fall where they do |
|
||||
| `patterns/` | Reusable solution shapes that hold across more than one subject |
|
||||
| `protocols/` | Communication protocols and standards, named in their usual spelling |
|
||||
| `workflows/` | Procedures and processes that recur across projects |
|
||||
| `decisions/` | Architectural and design decisions (see below) |
|
||||
| `problems/` | Recurring problems and the approaches taken to them |
|
||||
|
||||
Das sind Areas, keine Collections: sie erben diesen Contract und tragen keine
|
||||
eigene `COLLECTION.md`.
|
||||
These are areas, not collections: they inherit this contract and carry no
|
||||
`COLLECTION.md` of their own.
|
||||
|
||||
Die Zuordnung trifft niemand von Hand — sie steht als `layout:` in
|
||||
`types/concept.md`, und `wikitool new` legt eine neue Seite direkt dort ab.
|
||||
Eine Seite, die anderswo liegt, meldet `wikitool lint` als *misplaced*;
|
||||
`wikitool move --page "<Titel>"` bringt sie an ihren berechneten Ort.
|
||||
Nobody assigns them by hand — the mapping is the `layout:` in
|
||||
`types/concept.md`, and `wikitool new` puts a new page straight there. A page
|
||||
sitting anywhere else is reported by `wikitool lint` as *misplaced*;
|
||||
`wikitool move --page "<title>"` moves it to its computed location.
|
||||
|
||||
Die Aufteilung ist keine Geschmacksfrage, sondern das, was die Shard-Schwelle
|
||||
des Katalogs überhaupt wirksam macht: `index rebuild` teilt **pro Area**, und
|
||||
eine Collection ohne Areas teilt sich nie — mit 80 Seiten in einer einzigen
|
||||
Tabelle war die Schwelle hier ein toter Wert. Keine der sechs
|
||||
Areas liegt derzeit über der Schwelle, also bekommt auch keine einen eigenen
|
||||
Shard; wächst eine hinein, passiert das ohne Zutun.
|
||||
The split is not a matter of taste but what makes the catalog's shard threshold
|
||||
effective at all: `index rebuild` splits **per area**, and a collection without
|
||||
areas never splits — with 80 pages in a single table the threshold was a dead
|
||||
value here. None of the six areas is currently above it, so none gets a shard of
|
||||
its own; when one grows into it, that happens without anyone acting.
|
||||
|
||||
## Decisions
|
||||
|
||||
|
||||
Reference in New Issue
Block a user