docs: layout comments name all four shipped layout types; #150 changelog pointer and test docstring corrected
Files changed: - CHANGES.md - VERSION - tools/chemenu/commands/new_page.py - tools/chemenu/tests/test_new_page.py - tools/chemenu/type_resolver.py
This commit is contained in:
1 parent
6c0ebcc4f0
commit
dd885db625
5 files changed
+20
-9
No files matched your search
+12
-3
@@ -59,7 +59,7 @@ concern - readable here, never shipped as something to parse.
|
||||
|
||||
---
|
||||
|
||||
## 7.1.0-beta.30 - 2026-09-26 - new: concept/source record notes name their layout-computed subdirectory; source usage names its required fields (Gitea #150)
|
||||
## 7.1.0-beta.31 - 2026-09-26 - new_page/type_resolver comments no longer claim only entities declare a layout:
|
||||
|
||||
**Author:** Torben Nehmer
|
||||
|
||||
@@ -99,18 +99,27 @@ concern - readable here, never shipped as something to parse.
|
||||
- gates.md and a run_budget comment name kb pages by title, not by a path that moved
|
||||
- cli.py: removed a stale duplicate help-patch line outside the typer._click fallback's try (Gitea #148)
|
||||
- new: concept/source record notes name their layout-computed subdirectory; source usage names its required fields (Gitea #150)
|
||||
- new_page/type_resolver comments no longer claim only entities declare a layout:
|
||||
<!-- /wikitool:bumps -->
|
||||
|
||||
### new_page/type_resolver comments no longer claim only entities declare a layout:
|
||||
|
||||
Two code comments - `new_page.py`'s module docstring and `TypeResolver.get_layout`'s - still said
|
||||
subtype-driven placement applied to "currently just entities", the same stale assumption behind
|
||||
the `new` record's flat `concept`/`source` paths. They now name the four shipped type-specs that
|
||||
declare a `layout:`. A test docstring that claimed to run `new source`'s `usage` line verbatim
|
||||
now says what the test does: it passes the fields that line names. Comments only.
|
||||
|
||||
### new: concept/source record notes name their layout-computed subdirectory; source usage names its required fields (Gitea #150)
|
||||
|
||||
The `new`-command's `cli_contract` record promised `kb/concepts/<Name>.md` and
|
||||
`new`'s `cli_contract` record promised `kb/concepts/<Name>.md` and
|
||||
`kb/sources/Source - <Name>.md` for the `concept` and `source` variants - flat, with no
|
||||
subdirectory. Both type-specs have carried a `layout:` for a while (`concept_type`/`source_type`
|
||||
picks the area, same rule an entity or a project already follows), so the actual path is
|
||||
`kb/concepts/<subdir>/<Name>.md` and `kb/sources/<subdir>/Source - <Name>.md`. Nothing wrote a
|
||||
page to the wrong place - `new` computes the path itself - but the record is exactly what an
|
||||
agent reads to find one afterwards, and it was wrong: `instructions/gates.md` named two concept
|
||||
pages by their old flat path (fixed above) with the record itself as the plausible source of that
|
||||
pages by their old flat path (fixed in the gates.md entry further down) with the record itself as the plausible source of that
|
||||
assumption. Both notes now name the subdirectory and where it comes from; `comparison`'s note was
|
||||
checked against `types/comparison.md` and left alone; it genuinely has no `layout:`.
|
||||
|
||||
|
||||
Reference in new issue
Block a user