docs: write prose without dashes or semicolons

Profiles, the wiki, comments, docstrings, command output and schema descriptions carried em-dashes, clause-joining semicolons, unicode arrows, box-drawing banners and check-mark glyphs. Each sentence was rewritten rather than having its character swapped. Hashes, paths, source_ref values and every cited file:line are unchanged, which a comparison of each parsed profile against the previous revision confirms.

validate_pr comments now say PASS and FAIL in words, and source_ref values in a profile's structured blocks render as code. test_prose_style fails if any of these comes back, in tracked files or in the generated site.
This commit is contained in:
Abdessamad Derraz committed 2026-10-19 06:47:31 +02:00
1 parent 583031eda5
commit 4231902a6c
495 files changed
+2486 -2301

No files matched your search

+2 -2
View File
@@ -273,7 +273,7 @@ def _restore(cached: str, path: str) -> None:
"""Copy a fetched asset to its registered path, whole or not at all.
An interrupted copy at the final name is a truncated file the next scan
hashes and publishes; a scratch beside it is swapped in only once full.
hashes and publishes. A scratch beside it is swapped in only once full.
"""
directory = os.path.dirname(path)
os.makedirs(directory, exist_ok=True)
@@ -314,7 +314,7 @@ def _preserve_large_file_entries(files: dict, db_path: str) -> int:
# checkout without the release assets would drop every entry they
# hold, and the manifests regenerated from it would omit them.
raise SystemExit(
f"{db_path} is not valid JSON ({e}); restore it from git "
f"{db_path} is not valid JSON ({e}). Restore it from git "
"or regenerate it on a checkout holding the release assets before "
"scanning again"
) from e