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

+3 -3
View File
@@ -32,7 +32,7 @@ PAYLOAD = bytes(range(256)) * 400 # 102400 bytes
class _RangeHandler(http.server.BaseHTTPRequestHandler):
"""Serves PAYLOAD with Range support; fails first when asked to."""
"""Serves PAYLOAD with Range support and fails first when asked to."""
ranges: list[str] = []
fail_first: list[int] = []
@@ -312,8 +312,8 @@ class CommandLine(unittest.TestCase):
class ReviewCases(unittest.TestCase):
"""Saying no to the large-download question ended on Done; --quiet hid
fatal messages and swallowed --check; a resumed copy inflated the speed."""
"""Saying no to the large-download question ended on Done, --quiet hid
fatal messages and swallowed --check, and a resumed copy inflated the speed."""
def test_declining_is_not_done(self):
buf = io.StringIO()