From 9a1be6acde702ba7c69e31f6c9f00f636fcb22a7 Mon Sep 17 00:00:00 2001 From: Torben Nehmer Date: Thu, 17 Sep 2026 09:01:50 +0200 Subject: [PATCH] docs: die Zahl der nachgezogenen Pfadliterale korrigiert (33, nicht 27) Files changed: - CHANGES.md - VERSION - tools/chemenu/tests/test_source_hygiene.py --- CHANGES.md | 23 +++++++++++++++++++--- VERSION | 2 +- tools/chemenu/tests/test_source_hygiene.py | 2 +- 3 files changed, 22 insertions(+), 5 deletions(-) diff --git a/CHANGES.md b/CHANGES.md index d5f4074..5ce8b03 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -59,7 +59,7 @@ concern - readable here, never shipped as something to parse. --- -## 6.1.0-beta.7 - 2026-09-17 - Stale `wiki/` path literals swept out of tools/ and types/, with a test guarding against the next rename +## 6.1.0-beta.8 - 2026-09-17 - CHANGES.md/Guard-Docstring: die Zahl der nachgezogenen Pfadliterale korrigiert (33, nicht 27) **Author:** Torben Nehmer @@ -76,6 +76,7 @@ concern - readable here, never shipped as something to parse. **Low impact** - Stale `wiki/` path literals swept out of tools/ and types/, with a test guarding against the next rename +- CHANGES.md/Guard-Docstring: die Zahl der nachgezogenen Pfadliterale korrigiert (33, nicht 27) ### Upgrade-Prozedur als eigene Instruktion statt als Prosa in INSTALL.md @@ -332,12 +333,12 @@ schriebe das Feld nur wieder mit. ### Stale `wiki/` path literals swept out of tools/ and types/, with a test guarding against the next rename Die Wissensschicht wurde am 2026-08-21 von `wiki/` nach `kb/` umbenannt. Das Verzeichnis zog um, -die Zeichenkette nicht: 27 Stellen nannten weiter einen Pfad, den es nicht mehr gibt. Gemeldet +die Zeichenkette nicht: 33 Stellen nannten weiter einen Pfad, den es nicht mehr gibt. Gemeldet war davon eine - die Kopfzeile des Lint-Reports (``Scanned N pages under `wiki/` ``) - als kosmetischer Einzelfall. Der Scan selbst war immer korrekt: `run_lint(kb_dir)` laeuft ueber `kb/`, gezaehlt wird, was dort liegt. Falsch waren ausschliesslich die Beschriftungen. -Rund die Haelfte davon ist nutzersichtbar. Die Fehlermeldungen von `xref`, `cite`, `touch`, +Dreizehn davon sind nutzersichtbar. Die Fehlermeldungen von `xref`, `cite`, `touch`, `move`, `rm`, `rename`, `raw accept` und `log status` nannten `wiki/`, ebenso die `--help`-Texte von `cite sync --all`, `provenance rebuild-index --dry-run` und `move --reconcile`. Dazu die `description:`-Felder in `types/type-spec.schema.yaml`, die ueber `types describe` und ueber jede @@ -368,6 +369,22 @@ Schichten fuehrt. `--patch`: keine Schnittstelle aendert sich, kein Verhalten, keine Migration. Ein zurueckgerolltes Werkzeug gibt nur wieder die alten Beschriftungen aus. +### CHANGES.md/Guard-Docstring: die Zahl der nachgezogenen Pfadliterale korrigiert (33, nicht 27) + +Der Eintrag darueber nannte 27 nachgezogene Stellen und "rund die Haelfte davon nutzersichtbar". +Beides war falsch. Die 27 stammten aus einem `wc -l`, das nur `tools/**/*.py` gezaehlt hatte - +`tools/wikitool`, `types/type-spec.md` und die vier `description:`-Felder in +`types/type-spec.schema.yaml` fehlten darin. Nachgezaehlt am Commit selbst +(`git show | grep -c '^-.*wiki/'`): 33, davon 32 im Stack und eine auf der Seite +`Chemenu`. Nutzersichtbar sind davon dreizehn, also gut ein Drittel und nicht die Haelfte. + +Derselbe Zahlendreher stand im Docstring von `tools/chemenu/tests/test_source_hygiene.py`, wo er +kuenftigen Lesern erklaert, wogegen der Guard schuetzt - dort ebenfalls korrigiert. Dass diese +Korrektur einen eigenen Bump braucht, ist kein Formalismus: der Docstring liegt unter `tools/`, +und das Version-Gate in `.gitea/workflows/ci.yml` ist nach Pfad geschnitten, nicht nach Absicht. + +`--patch`: reine Prosakorrektur, kein Verhalten, keine Schnittstelle. + --- ## 6.0.1 - 2026-09-16 - docs toc/verify erreichen die .template-Form einer Referenzdatei diff --git a/VERSION b/VERSION index ffb3907..bcf5f49 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -6.1.0-beta.7 +6.1.0-beta.8 diff --git a/tools/chemenu/tests/test_source_hygiene.py b/tools/chemenu/tests/test_source_hygiene.py index 8650b0a..3f339af 100644 --- a/tools/chemenu/tests/test_source_hygiene.py +++ b/tools/chemenu/tests/test_source_hygiene.py @@ -1,7 +1,7 @@ """Guard against a renamed stage leaving its old path standing in source. `wiki/` was renamed to `kb/` on 2026-08-21. The directory moved; the string did -not, in 27 places - error messages, `--help` text, docstrings and the lint +not, in 33 places - error messages, `--help` text, docstrings and the lint report's own header, all naming a directory that no longer exists. Nothing caught it, because no check reads a path literal in source.