Repository navigation
Should a name word after a credential join the suffix? John Smith PhD Jones reads middle Smith PhD #602
Description
Why. A credential or generational suffix written in the middle of a name part has no rule of its own today. Whatever reads the part decides it by accident, and the three comma shapes give three different answers:
| Input | Today (master at aa401d8) |
|---|---|
John Smith PhD Jones |
given John, middle Smith PhD, family Jones |
John Smith PhD MD Jones |
middle Smith PhD MD, family Jones |
John Smith Jr. Jones |
middle Smith Jr., family Jones |
John Smith III Jones |
middle Smith III, family Jones |
Smith, John PhD Jones |
given John, middle Jones, family Smith, suffix PhD |
John Smith, PhD, Jones |
given John, family Smith, suffix PhD, Jones (comma-structure) |
John Smith, Jr., Jones |
suffix Jr., Jones (comma-structure) |
Smith John PhD Jones (FAMILY_FIRST) |
family Smith, given John, middle PhD Jones |
So without a comma the credential lands in a middle name. After a family comma it is a suffix and the word behind it becomes a middle name. After a suffix comma everything from the credential on is already a suffix, which is C2's tail rule.
Rationale. A writer who puts an unambiguous post-nominal after a name has marked where the post-nominals begin. A name word after it is more likely a credential the vocabulary doesn't list, or junk, than a resumed name. Reading the name past a credential, as the no-comma path does, turns a credential into a middle name, which is the one reading nobody intends. The suffix-comma path already reads it the proposed way.
Proposed statement.
-
The rule. In a part that a trailing rule reads, an unambiguous suffix word that stands after the name core starts the suffix run. Every word from it to the end of the part reads as a suffix, except a title word, which reads as a title:
John Smith PhD Professor→ suffix PhD, titleProfessor.Eric H. Holder Jr. Attorney General→ suffix Jr., titleAttorney General. The comma formEric H. Holder, Jr. Attorney Generalalready reads this way.
A title word cannot start the run. 746 title words are in no suffix set (measured 2026-10-04), many of them surnames (
King,Bishop,Judge), andMary Jane King Smithmust keep family Smith. The credential is the writer's mark that the post-nominals have begun, and a title has no such force. Reading a title from the end of a name otherwise still needs a comma or a period (H5).The parts a trailing rule reads are:
- a name with no comma;
- the part before a suffix comma;
- the given part after a family comma.
-
What starts the run. A Latin credential acronym or a generational word (
Jr.,Sr.,III), outside these exclusions:- the ambiguous class (
ba,do,ed,jd,lac,ma,meng); - a single letter shaped like an initial (
V,I, whileIIIdoes start a run); - a connective that P3 joins between two name words (
Josep Carod i Rovirais unchanged); - the non-Latin honorific words (
さん,씨,जी,先生and the rest), because an honorific followed by a name word is a different situation from a credential followed by one.
A word that is also a title (
MD,Ms,Lt.,Sr.) starts the run, because position decides: after the name core it is read as the suffix. - the ambiguous class (
-
The name core. With no comma, at least two name words must stand before the suffix word, because the family name has to exist first. After a family comma, at least one given word must. The comma already fixed the family.
-
Reported. Each name word the run absorbs is reported
suffix-or-name, because a reader would hesitate overJonesinJohn Smith PhD Jones.
Examples (proposed, predicted):
| Input | Proposed |
|---|---|
John Smith PhD Jones |
given John, family Smith, suffix PhD Jones |
John Smith Jr. Jones |
suffix Jr. Jones |
Smith, John PhD Jones |
given John, family Smith, suffix PhD Jones |
Smith John PhD Jones (FAMILY_FIRST) |
family Smith, given John, suffix PhD Jones |
John Smith PhD Jones Prof. |
title Prof., suffix PhD Jones |
John Smith PhD Professor |
suffix PhD, title Professor |
Eric H. Holder Jr. Attorney General |
suffix Jr., title Attorney General |
Mary Jane King Smith |
unchanged: a title word does not start the run |
Josep Carod i Rovira |
unchanged: P3 joins the connective |
John Smith MA Jones |
unchanged, because MA is ambiguous |
John Smith V Jones |
unchanged, because V is initial-shaped |
John Jr. Smith / John PhD Smith |
unchanged, because only one name word stands before (boundary) |
Accepted consequences.
- An unlisted word lands in
suffix. The field already holds three kinds of thing (decisions.md#suffix-field-composition), and this adds a fourth: name words the writer placed after a credential. - The M2 rethink (Rethink the maiden-marker rule (M2): a marker stands after the current name and takes words up to the trailing suffix run #601) interacts with this.
Jane Doe PhD nee Smithwould read suffixPhD nee Smith, because the marker after a suffix is a word there.
Alternative considered. Lift the credential out and keep the name word as the family: John Smith PhD Jones would read given John, middle Smith, family Jones, suffix PhD. That is the family-comma path's reading today. It keeps every name word in a name field, but it treats a credential as something written in the middle of a name, which is the reading the rationale rejects.
Open questions.
Report it?Decided: yes (point 4).Split off to Should a comma part opening with a credential be a suffix comma?John Smith, PhD JonesJohn Smith, PhD Jonesreads familyJohn Smith#603. It is a comma-structure question.Generational versus credentialDecided: both start the run (point 2).
Reach (measured 2026-10-04). Over the differential corpora (1,507 names), the trigger (an unambiguous suffix after at least two name words, then a name word in the same comma part) matches 8 names. All 8 are synthetic test strings or delimiter rows, not names someone typed. The rule is about consistency between the comma shapes, and about #601's clause (Jane Doe nee Smith PhD Smith), more than about real input.
How we'll know.
- Run the differential gate at every ledgered baseline, and classify every moved name.
Measure how many corpus names have an unambiguous suffix followed by a name word in the middle of a part(done; see Reach).
Exclusions.
- No vocabulary changes.
- Ambiguous acronyms keep their words-to-spare rule.
- A part after a second comma stays C2's question.
Related: #601, #603, #548 (the two-Smith examples came from there), C2.
Activity
Simplify the #601/#602 code (/simplify pass)
Merge origin/master (#608, #606) into the #601/#602 branch
Merge pull request #609 from derek73/feat/issue-601-602-m2-rethink
A credential after the name core starts a suffix run to the end of it…
A maiden marker counts only behind a surname, up to the name's traili…
Fix what the review of derek73#601/derek73#602 found
Merge origin/master (derek73#604) into the derek73#601/derek73#602 br…
Share P6's particle tail and the maiden take's candidates as one pred…
Read a comma part a credential opens as the postnominal part; titles …
Decide P6's comma site in assign, in the pass that reads the given pa…
Fix the counting view's index, unit reach and report hand-off (derek7…
Count the chain's units in S2's read instead of merging a copy (derek…
Finish derek73#620: units through the run start, report grouping, doc…
Fix #627's review findings: a guard row and precise docs
Count a lone particle with the run behind it as a name word (#627) (#631
Read every citation shape the tree writes; fix what that exposes
Read every citation shape the tree writes; fix what that exposes
Check rule citations in every shape, ledgers included; fix the stale …
Fix prose the 2.4 changes made stale (pre-release sweep) (#647)
Read junior and senior in other languages as suffixes (#681)
Read junior and senior in 34 more languages; let any suffix word star…
Split rules/S2 and decisions/S2 into one rule per piece of evidence (#…