Skip to content

Say what a strict choice keeps of a native-script word - #1148

Merged
derek73 merged 5 commits into
masterfrom
docs/native-script-readings
Nov 8, 2026
Merged

derek73 merged 5 commits into
masterfrom
docs/native-script-readings

Conversation

@derek73

@derek73 derek73 commented Nov 8, 2026 •

Copy link
Copy Markdown
Owner

Follow-up to #1146 and #1147: the "native-script vocabulary" wording sweep #1147 listed, plus the findings of a post-merge review of its last fix commit (af7431c).

What changes

  • A native-script word under a strict choice. strict_kept keeps a reading when its file is chosen, it is mul.toml's, or its word has a letter and no Latin letter, and choose then runs as under a plain choice. So a strict choice keeps a native-script word's readings, name readings included, exactly as a plain choice of the same languages keeps them: a default = false reading stays off unless its file is chosen. Strict pt reads गुरु प्रसाद शर्मा title गुरु, ne.toml's given reading of it being off; strict ne reads given गुरु.
  • README, building a parser. The first build of a choice loads the reading index only unless a parse has already loaded it: after a default parse of a name holding a listed word (Dr. John Smith Jr.), the first parser_for(locales.ES) took about 12 ms, not 37–43. The figures stand; the sentence now says the index is "about two thirds of the cost", "unless a parse has already loaded it".

How it was checked

  • On this branch: for every one of the 243 native-script words in the reading index, readings_of under a strict choice equals the plain choice's, for pt, ne, hi, ru, ja, ko and en (0 mismatches). Strict en keeps uk.toml's family reading of пан.
  • ruff, python -m doctest README.rst, sphinx-build -b doctest and -b html (no output), and the doc-citation, design-docs, rules and reading-index tests pass.

Reviews

  • pr-review-toolkit:comment-analyzer, post-merge, on af7431c: 13 claims exact, 2 overbroad (the README first-build scope; "every file's" for a word in another script). Both fixed in 03f10ed, the first commit here, which also extended the qualifier to the sweep's own wording: a default = false reading stays off.
  • pr-review-toolkit:comment-analyzer on 03f10ed: the claim holds over every tag alone and in pairs (0 differences). Two RFC sentences (verb agreement, the table row), the README's "compiles" for the index (it loads it), and RFC sites at the strict hu/ko sentences and the no-language refusal. Fixed in b7d8c11.
  • design-docs-reviewer on 03f10ed: the RFC overview still had the old definition, and the Standing line said what no dated entry said. b7d8c11 added a dated 2026-11-07 Say what a strict choice keeps of a native-script word #1148 entry and the overview fix.
  • second round, design-docs-reviewer on b7d8c11: "clarified by" is not an edit decisions/README.md allows, so the entry is now a partial supersession; it named strict_kept for 3j, when the filter was then strict_pool's; the RFC's Status paragraph and 3j row, and strict hu read as the default's. Fixed in d83c3c8.
  • third round, design-docs-reviewer on d83c3c8: no confirmed defects (strict hu equals the default's 293 native-script readings; quote verbatim; 3,240 choices, 0 differ). One low finding, the 3j head lacking the Say what a strict choice keeps of a native-script word #1148 note, fixed in the last commit, a one-clause addition checked by the doc tests.

🤖 Generated with Claude Code

A strict choice keeps a native-script word's readings, name readings
included, exactly as a plain choice of the same languages keeps them:
a reading written default = false stays off unless its file is chosen
(strict pt reads गुरु प्रसाद शर्मा title गुरु). Seven sites said
"native-script vocabulary", leaving the name readings unsaid
(Lexicon.strict, parser_for and its refusal, the UNCHOOSABLE comment,
AGENTS.md, mechanisms.md, decisions/vocabulary-model's Standing
summary, the RFC), and #1146/#1147's customize.rst and docs/AGENTS.md
said a word in another script keeps "every file's" readings.

Also from the post-merge review of af7431c: the README's first-build
cost of a choice includes the reading index only unless a parse has
already loaded it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@derek73 derek73 added this to the 3.0 milestone Nov 8, 2026
@derek73 derek73 added the docs Documentation fixes and updates label Nov 8, 2026
@derek73 derek73 self-assigned this Nov 8, 2026
derek73 and others added 4 commits November 7, 2026 21:40
A dated decisions entry (2026-11-07 #1148) states what a strict choice
keeps of a native-script word, with head notes on the 2026-10-30
file-strict and 2026-11-02 #1005 entries and the Standing lines
pointing at it, so a Standing line no longer says what no entry says.

The RFC's overview, its strict-hu and strict-ko sentences, its
no-language refusal sentence and its operations-table row now say
native-script words' readings; its File-strict paragraph's verb agrees
again. The README's first-build sentence loads, not compiles, the
reading index.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
decisions/README.md allows four kinds of edit to an entry, and
"clarified by" is none of them; the 2026-10-30 entry's item 1 also
says name readings leave. So the new entry SUPERSEDES both clauses in
part, and the two heads say so in the sanctioned form. The entry names
the filter as it was at 3j (strict_pool's) and since #1001
(strict_kept). The RFC's Status paragraph and phasing row get the same
parenthetical as its overview, and strict hu's readings are the
default's, a plain hu choice being refused.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@derek73
derek73 merged commit dbc2fc2 into master Nov 8, 2026
13 checks passed
@derek73
derek73 deleted the docs/native-script-readings branch November 8, 2026 05:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation fixes and updates

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant