Skip to content

docs(C1): a particle that is also a credential counts in the run (#554) - #574

Merged
derek73 merged 4 commits into
masterfrom
docs/issue-554-particle-credential-run
Oct 2, 2026
Merged

derek73 merged 4 commits into
masterfrom
docs/issue-554-particle-credential-run

Conversation

@derek73

@derek73 derek73 commented Oct 1, 2026 •

Copy link
Copy Markdown
Owner

Closes #554 by choosing option (a), which is what the parser already does. No parse changes.

After a comma, a word that is both a particle and unambiguous suffix vocabulary (vd, mc) still counts as a suffix word in C1's run test. S2's company rule still won't let that word vouch for the word behind it. The issue treated this as two rules giving different answers to one question. It's actually two different questions:

  • Run membership asks what the word is. vd is unambiguous suffix vocabulary.
  • Company asks whether the word vouches for the word behind it. A particle can't, because P2 joins it forward to exactly that word.

Evidence. Neither reading of vd Ma after a comma is realistic, so the mixed-case form decides nothing. Uniform case is where the decision matters, because there are no capitals for S2 to read and the vocabulary is the only signal. There the part reads as the credential run, which is the reading a person would take:

text reading on master
John Smith, vd Ma suffix vd Ma, reports suffix-or-name
JOHN SMITH, VD MA suffix VD MA, reports suffix-or-name
john smith, vd ma suffix vd ma, reports suffix-or-name

mc reads the same way in every casing. This is also what 1.4.0 read; 2.0.0 through 2.3.0 read the whole name as the family. Option (b) would have needed a particle exception in C1 and in #567's paired-initials check. Its result would be the family JOHN SMITH VD MA with no given name. #563's site (García Márquez, vd G.J.) reads exactly like PhD G.J., so it needs no change.

Changes

Follow-up

#573 covers the uniform-case defects found while measuring this. In SMITH VD MA, JOHN, VD is pulled out from between the family words. In DOE, JANE PHD VD MA, VD lands in front of the family name. In SMITH, VD MA, VD stays behind in the family. That issue also covers #554's aside about Doe, Jane PhD vd Ma going into middle without a report.

Verification

  • Full suite: 10626 passed. ruff check is clean.
  • The differential gate exits 0 at 1.4.0, 2.0.0, 2.1.0, 2.2.0 and 2.3.0, with 0 unexplained. The radar-unclassified counts are the same as before this change.
  • Review: a design-docs-reviewer pass before the PR, then /pr-review-toolkit:review-pr (code, comments, tests), then a second review of the fix commit. No parse claim was wrong. The rounds fixed the clause's wording and scope, added the pinning examples, and corrected one history claim: the Smith vd Ma, John split shipped in 2.2.0 and 2.3.0 and was fixed by Case and shape decide a bare ambiguous credential acronym (#289, #516) #530, not only inside fix(#544): a credential run keeps its ambiguous members #552.

🤖 Generated with Claude Code

derek73 and others added 2 commits October 1, 2026 15:21
Settles #554 as option (a), the shipped behavior; no parse moves.
After a comma, a word of both the particle and the unambiguous suffix
vocabulary (vd, mc) counts as a suffix word in C1's run test, while
S2's company still refuses to let it speak for the word behind it.
These are two questions, not one answered twice: run membership asks
what the word is, company asks whether a particle can vouch for the
word P2 joins it to.

Written in one case, where no capitals speak, the part reads as the
credential run (JOHN SMITH, VD MA -> suffix VD MA, reported), which
is the reading a reader takes; (b) would give that input a one-word
listing form with no given name.

rules.md#C1 gains the clause and two examples; decisions.md#C1 records
the decision. The examples enter the rules corpus, so the #544 run rule
gains both names in the 2.0.0-2.3.0 ledgers and the moved corpus claims
are re-recorded. The gate exits 0 at every baseline.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@derek73 derek73 added this to the 2.4 milestone Oct 1, 2026
@derek73 derek73 added the docs Documentation fixes and updates label Oct 1, 2026
@derek73 derek73 self-assigned this Oct 1, 2026
@codecov

codecov Bot commented Oct 1, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.87%. Comparing base (fc682e3) to head (372d5ec).
⚠️ Report is 6 commits behind head on master.

Additional details and impacted files
@@           Coverage Diff           @@
##           master     #574   +/-   ##
=======================================
  Coverage   98.87%   98.87%           
=======================================
  Files          45       45           
  Lines        3990     4017   +27     
=======================================
+ Hits         3945     3972   +27     
  Misses         45       45           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

derek73 and others added 2 commits October 1, 2026 18:10
…scope

- rules.md#C1: the clause now leads with what it decides (a word's
  particle reading does not take it out of the run) and names the two
  runs plainly; "such a part" gets an explicit antecedent.
- New C1 examples pin the uniform-case report and the clause's scope:
  'John Smith, Jr vd' is silent, 'John Smith, Jr do' reports (do is a
  word of the ambiguous class, so the clause does not reach it).
- decisions.md#C1: PR #552's split was an intermediate state, never
  released; 1.4.0 read these names as (a) does (verified against the
  wheel); do's membership shown by a recompute; shorter Open: handle.
- Ledgers: comments carry the "unambiguous" qualifier and quote the new
  clause; 'John Smith, Jr do' joins the #544 run rule at 2.0.0-2.3.0,
  with each baseline's own reading. Moved corpus claims re-recorded.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- decisions.md#C1: the 'Smith vd Ma, John' split was not only an
  intermediate state of #552 -- 2.2.0 and 2.3.0 shipped it and #530
  removed it this cycle (measured against the wheels).
- The Open: handle names the shapes #573 actually covers: before a
  comma and after a family comma, not after a suffix comma.
- 'John Smith, Jr do' is not a boundary of the particle clause: do is
  still a run member and the part still flips; only the report differs.
  The `· boundary` label and the ledgers' "boundary" wording go.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@derek73
derek73 merged commit 65afcdb into master Oct 2, 2026
11 checks passed
@derek73
derek73 deleted the docs/issue-554-particle-credential-run branch October 2, 2026 02:26
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.

Should a particle that is also a credential (vd, mc) count in a credential run after a comma?

1 participant