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
@@ -134,7 +134,7 @@ def _validate_pack_manifests(dist: Path) -> list[str]:
return _scan_pack_manifests(dist)
except ArtifactLockBusy:
print(
f"note: {dist.name} is being written; skipping pack manifests",
f"note: {dist.name} is being written, skipping pack manifests",
file=sys.stderr,
)
return []
@@ -340,7 +340,7 @@ def _semantic_install_checks(path: Path, manifest: dict) -> list[str]:
def unchecked_formats() -> list[str]:
"""Formats the schemas declare that this jsonschema install cannot check.
date-time and uri need the format extras; without them the ten format
date-time and uri need the format extras. Without them the ten format
constraints of the published schemas were accepted unread.
"""
used = {