dist export-Doku nennt raw/{articles,documents,notes,assets}/ und die passenden incoming/-Typverzeichnisse, die seit #67 nicht mehr angelegt werden #93

Closed
opened 2026-09-11 11:12:13 +00:00 by torben · 1 comment
Owner

Aufgefallen als Nebenbefund in der Sitzung zu #88 (2026-09-11), beim Nachziehen der\ndist export-Zeile in tools/CONTRACT.md.\n\n## Befund\n\ntools/CONTRACT.mds dist export-Zeile und der --help-Docstring des Kommandos selbst\n(tools/chemenu/commands/dist_cmd.py) behaupteten wortgleich, ein frischer Export lege leere\nraw/{articles,documents,notes,assets}/ und die passenden incoming/-Typverzeichnisse an.\nGegengeprüft per tools/wikitool dist export <target> in ein leeres Scratch-Verzeichnis:\nraw/ enthält nach dem Export nur .gitkeep und CONTRACT.md, incoming/ nur .gitkeep -\nkeine Typunterverzeichnisse unter keinem der beiden Wurzeln. #67 hatte den Export-Pfad auf zwei\nflache Anker verkürzt, ohne die zwei Prosa-Stellen nachzuziehen.\n\n## Ergebnis\n\nBeide Stellen sind korrigiert, raw/{articles,documents,notes,assets}/ kommt in keinem\nausgelieferten Dokument mehr vor:\n\n- tools/CONTRACT.mds dist export-Zeile beschreibt jetzt die zwei flachen Anker\n (raw/.gitkeep, incoming/.gitkeep) statt der vier Typverzeichnisse.\n- Der --help-Docstring in tools/chemenu/commands/dist_cmd.py zieht dieselbe Korrektur nach.\n- Kein Test regressiert: volle pytest-Suite (1195 passed), docs verify, instructions\n verify und ein manueller dist export-Replay in ein leeres Verzeichnis bestätigen weiterhin\n nur die zwei flachen Anker.\n- Changelog-Eintrag als PATCH (5.0.0-beta.16, reine Dokumentkorrektur, keine\n Verhaltensänderung).\n\nIn derselben Sitzung gleich mitkorrigiert, weil dieselbe Ursache und beim Grep sofort sichtbar:\ndrei weitere Stellen benutzten noch das veraltete raw/*/.gitkeep-Glob (impliziert mehrere\nTyp-Unterverzeichnisse) statt des seit #67 tatsächlich einzigen flachen raw/.gitkeep-Ankers -\ntools/CONTRACT.mds dist upgrade-Zeile, docs/ownership-and-templates.md und der\napply_upgrade-Docstring in dist_cmd.py. Verhalten war davon nie betroffen\n(chemenu.ownership.is_export_stub/is_upgrade_preserved matchen per Dateiname, nicht\nPfadtiefe) - reine Prosa-Korrektur, im selben Zug mitgelaufen (5.0.0-beta.17).\n\nVeröffentlicht: Commit a970352 auf main.\n\n## Akzeptanzkriterien\n\n- [x] tools/CONTRACT.mds dist export-Zeile beschreibt den tatsächlichen flachen Export\n (raw/.gitkeep, incoming/.gitkeep) statt der vier Typverzeichnisse\n- [x] Der --help-Docstring in tools/chemenu/commands/dist_cmd.py zieht dieselbe Korrektur nach\n- [x] Kein Test regressiert; ein Export-Replay in ein leeres Verzeichnis bestätigt weiterhin nur\n die zwei flachen Anker\n- [x] Changelog-Eintrag, PATCH (reine Dokumentkorrektur, keine Verhaltensänderung)\n

Aufgefallen als Nebenbefund in der Sitzung zu #88 (2026-09-11), beim Nachziehen der\n`dist export`-Zeile in `tools/CONTRACT.md`.\n\n## Befund\n\n`tools/CONTRACT.md`s `dist export`-Zeile und der `--help`-Docstring des Kommandos selbst\n(`tools/chemenu/commands/dist_cmd.py`) behaupteten wortgleich, ein frischer Export lege leere\n`raw/{articles,documents,notes,assets}/` und die passenden `incoming/`-Typverzeichnisse an.\nGegengeprüft per `tools/wikitool dist export <target>` in ein leeres Scratch-Verzeichnis:\n`raw/` enthält nach dem Export nur `.gitkeep` und `CONTRACT.md`, `incoming/` nur `.gitkeep` -\nkeine Typunterverzeichnisse unter keinem der beiden Wurzeln. #67 hatte den Export-Pfad auf zwei\nflache Anker verkürzt, ohne die zwei Prosa-Stellen nachzuziehen.\n\n## Ergebnis\n\nBeide Stellen sind korrigiert, `raw/{articles,documents,notes,assets}/` kommt in keinem\nausgelieferten Dokument mehr vor:\n\n- `tools/CONTRACT.md`s `dist export`-Zeile beschreibt jetzt die zwei flachen Anker\n (`raw/.gitkeep`, `incoming/.gitkeep`) statt der vier Typverzeichnisse.\n- Der `--help`-Docstring in `tools/chemenu/commands/dist_cmd.py` zieht dieselbe Korrektur nach.\n- Kein Test regressiert: volle `pytest`-Suite (1195 passed), `docs verify`, `instructions\n verify` und ein manueller `dist export`-Replay in ein leeres Verzeichnis bestätigen weiterhin\n nur die zwei flachen Anker.\n- Changelog-Eintrag als PATCH (5.0.0-beta.16, reine Dokumentkorrektur, keine\n Verhaltensänderung).\n\nIn derselben Sitzung gleich mitkorrigiert, weil dieselbe Ursache und beim Grep sofort sichtbar:\ndrei weitere Stellen benutzten noch das veraltete `raw/*/.gitkeep`-Glob (impliziert mehrere\nTyp-Unterverzeichnisse) statt des seit #67 tatsächlich einzigen flachen `raw/.gitkeep`-Ankers -\n`tools/CONTRACT.md`s `dist upgrade`-Zeile, `docs/ownership-and-templates.md` und der\n`apply_upgrade`-Docstring in `dist_cmd.py`. Verhalten war davon nie betroffen\n(`chemenu.ownership.is_export_stub`/`is_upgrade_preserved` matchen per Dateiname, nicht\nPfadtiefe) - reine Prosa-Korrektur, im selben Zug mitgelaufen (5.0.0-beta.17).\n\nVeröffentlicht: Commit `a970352` auf `main`.\n\n## Akzeptanzkriterien\n\n- [x] `tools/CONTRACT.md`s `dist export`-Zeile beschreibt den tatsächlichen flachen Export\n (`raw/.gitkeep`, `incoming/.gitkeep`) statt der vier Typverzeichnisse\n- [x] Der `--help`-Docstring in `tools/chemenu/commands/dist_cmd.py` zieht dieselbe Korrektur nach\n- [x] Kein Test regressiert; ein Export-Replay in ein leeres Verzeichnis bestätigt weiterhin nur\n die zwei flachen Anker\n- [x] Changelog-Eintrag, PATCH (reine Dokumentkorrektur, keine Verhaltensänderung)\n
torben added the prio/waitingsize/Sarea/distributionkind/defect labels 2026-09-11 11:12:13 +00:00
Author
Owner

Beide Doku-Stellen korrigiert und veröffentlicht (Commit a970352, PATCH 5.0.0-beta.16). Dabei denselben Prosa-Fehler (raw/*/.gitkeep-Glob statt des flachen Ankers) an drei weiteren Stellen gefunden und im selben Zug mitkorrigiert (5.0.0-beta.17) - Verhalten war nie betroffen, reine Prosa. Alle vier Akzeptanzkriterien erfüllt, volle Testsuite grün.

Beide Doku-Stellen korrigiert und veröffentlicht (Commit `a970352`, PATCH 5.0.0-beta.16). Dabei denselben Prosa-Fehler (`raw/*/.gitkeep`-Glob statt des flachen Ankers) an drei weiteren Stellen gefunden und im selben Zug mitkorrigiert (5.0.0-beta.17) - Verhalten war nie betroffen, reine Prosa. Alle vier Akzeptanzkriterien erfüllt, volle Testsuite grün.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: torben/chemenu#93