docs: page-material passages name subtype templates (#117)
Files changed: - CHANGES.md - VERSION - docs/language-boundaries.md - tools/chemenu/commands/dist_cmd.py - types/type-guidance.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
d8cb494d58
commit
dd565d249f
6 files changed
+26
-12
No files matched your search
@@ -90,7 +90,9 @@ Making the control plane English does not make the instance's language an implem
|
||||
experiences:
|
||||
|
||||
- **Page text.** Every page under `kb/`, and inside the page type-specs exactly the parts that
|
||||
become page text - each one's `## Template` block and its `layout:` titles.
|
||||
become page text - each one's `## Template` block, its `layout:` titles, and the subtype
|
||||
templates `types/<name>.<value>.md` beside it, which are page text from the first line to the
|
||||
last.
|
||||
- **What an agent says.** An agent speaks the KB language, whatever the file it just read was
|
||||
written in. An instruction that models a sentence for the operator writes that model in
|
||||
English, like the rest of the control plane, and the agent delivers it in the instance's
|
||||
@@ -103,8 +105,8 @@ English instructions. The English is what the machinery is written in, not what
|
||||
|
||||
A page type's contract is where the two languages meet most closely, and it is worth knowing
|
||||
which part is which before editing any of it. Its authoring guidance addresses an agent and is
|
||||
English; its `## Template` block and `layout:` titles become the literal headings of pages and
|
||||
follow the KB language; its field names and enum values are identifiers and are translated in
|
||||
English; its `## Template` block, `layout:` titles and subtype templates become the literal
|
||||
headings of pages and follow the KB language; its field names and enum values are identifiers and are translated in
|
||||
neither direction.
|
||||
|
||||
The language line did not move when the *file* line did. A `root: kb` type-spec may now put its
|
||||
|
||||
Reference in new issue
Block a user