feat: a subtype gets its own page skeleton from types/<type>.<value>.md (#117)
Files changed: - AGENTS.md - CHANGES.md - README.md - VERSION - docs/ownership-and-templates.md - instructions/evolve-subtypes.md - instructions/setup-instance.md - instructions/subtype-templates.md - instructions/upgrade-instance.md - tools/CONTRACT.md - tools/chemenu/commands/dist_cmd.py - tools/chemenu/commands/docs_verify.py - tools/chemenu/commands/new_page.py - tools/chemenu/tests/test_dist_cmd.py - tools/chemenu/tests/test_docs_verify.py - tools/chemenu/tests/test_new_page.py - tools/chemenu/tests/test_toc.py - tools/chemenu/tests/test_type_resolver.py - tools/chemenu/toc.py - tools/chemenu/type_resolver.py - types/concept.decision.md - types/entity.guidance.md - types/entity.md - types/entity.person.md - types/type-spec.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
c261b8f4ca
commit
d8cb494d58
25 files changed
+747
-51
No files matched your search
+31
-1
@@ -59,7 +59,7 @@ concern - readable here, never shipped as something to parse.
|
||||
|
||||
---
|
||||
|
||||
## 8.0.0-beta.30 - 2026-10-03 - lint: a wikilink wrapped across a line break is its own finding; rename and rm see it
|
||||
## 8.0.0-beta.31 - 2026-10-03 - new: a subtype gets its own page skeleton from types/<type>.<value>.md
|
||||
|
||||
**Author:** Torben Nehmer
|
||||
|
||||
@@ -102,6 +102,7 @@ concern - readable here, never shipped as something to parse.
|
||||
- publish keeps a closing trailer block of --message last, so git reads Co-Authored-By again (#149)
|
||||
- Stack-Entwicklung in drei Phasen: stack-dev (Design), stack-build, stack-close - Übergabe über den Tracker, kein Modellwechsel in der Sitzung
|
||||
- raw fetch: a sanctioned intake for a URL into incoming/
|
||||
- new: a subtype gets its own page skeleton from types/<type>.<value>.md
|
||||
|
||||
**Low impact**
|
||||
- version bump no longer points at version release in its output
|
||||
@@ -143,6 +144,35 @@ concern - readable here, never shipped as something to parse.
|
||||
- lint: a wikilink wrapped across a line break is its own finding; rename and rm see it
|
||||
<!-- /wikitool:bumps -->
|
||||
|
||||
### new: a subtype gets its own page skeleton from types/<type>.<value>.md
|
||||
|
||||
A type-spec carried one `## Template` block for every value of its subtype field, so `wikitool
|
||||
new` scaffolded a person with `Version`, `Sprache/Technik` and `Repository`, and a decision with
|
||||
"Wann zu verwenden" instead of context and consequences - and authors rebuilt those pages by
|
||||
hand. Now a file `types/<type>.<value>.md` beside the type-spec is the skeleton for pages whose
|
||||
subtype field holds `<value>`: plain markdown in the KB language, no frontmatter, its name the
|
||||
only declaration. It replaces the block whole; every subtype without such a file, and every type
|
||||
without `subtype_field:`, scaffolds byte-identically to before. `guidance` is reserved for
|
||||
`<type>.guidance.md`. The stack ships two: `types/entity.person.md` (Rolle, Zugehörigkeit,
|
||||
Wirkungszeitraum, Beiträge) and `types/concept.decision.md` (Kontext, Entscheidung, Alternativen,
|
||||
Konsequenzen, Status).
|
||||
|
||||
`docs verify` reports a subtype template whose `types/<type>.md` is no type-spec with
|
||||
`subtype_field:`, whose value the field's enum does not allow, or which carries frontmatter -
|
||||
each would otherwise be a file nothing reads. Subtype templates never get a table-of-contents
|
||||
region, since `new` copies them into every page. They are page material of an instance-owned type,
|
||||
so `dist export` ships them as `.template`, `find_leaks` refuses one under its own name, and
|
||||
`dist adopt` takes them; no export carries one unsuffixed, so no `dist upgrade` writes over an
|
||||
adopted one. A new manual instruction, `instructions/subtype-templates.md`, is the interview that
|
||||
finds subtypes whose pages depart from their template (at least three pages, the same way) and
|
||||
writes the template the user accepts. `types/entity.md` and its guidance no longer speak of
|
||||
"projects" since the subtype became `codebase`.
|
||||
|
||||
**For an existing instance:** nothing changes until it adopts a template - `dist upgrade` lays
|
||||
`types/entity.person.md.template` and `types/concept.decision.md.template` beside the adopted
|
||||
type-specs; `tools/wikitool dist adopt <path>` takes one, leaving it takes none. Both are valid.
|
||||
No page changes (Gitea #117).
|
||||
|
||||
### lint: a wikilink wrapped across a line break is its own finding; rename and rm see it
|
||||
|
||||
A `[[...]]` written across a line break - prose wrapped at a fixed column, with the break
|
||||
|
||||
Reference in new issue
Block a user