Trim the 2.4.0 release notes to index bullets and link issues

[derek73]

Summary

• 2.4.0 entry rewritten as an index. Each bullet is a bold lead, one before/after example naming the releases it differs from, a limit sentence only where a caller would trip on it, and issue links. The details stay in the issues and docs/design/decisions.md. 10,765 words / 45 bullets → 1,491 words / 32 bullets.

• Merged bullets a user sees as one change: performance (perf(pipeline): copy stage state without dataclasses.replace #546, Parsing slows quadratically for a long given part after a family comma (Doe, Jane …) #553, Parsing slows quadratically when titles and credentials alternate at the end of a name #558, Many leading titles plus many surname particles slow parsing quadratically #559), v1 Constants entries (A Constants set entry with edge whitespace raises ValueError at the first parse: c.suffix_not_acronyms.add('ma ') then HumanName('John Smith', c) #541, A v1 Constants entry that is only a CJK full stop raises ValueError at the first parse: c.titles.add('。') then HumanName('john smith', c) #582), decomposed accents (capitalize() breaks a decomposed (NFD) word at its combining mark: josé garcía typed NFD gives José GarcíA #542, initials() drops the accent from a decomposed (NFD) name: émile zola gives e. z. #585), credential runs (Should a name word after a credential join the suffix? John Smith PhD Jones reads middle Smith PhD #602/Should a comma part opening with a credential be a suffix comma? John Smith, PhD Jones reads family John Smith #603/Rethink the suffix-comma rule (C1): decide the comma's structure once, after the words are tagged #613 and Should a credential run after a comma keep its comma when the last word is an ambiguous acronym? John Smith, PhD MEng reads first PhD, last John Smith #544/Why does John Smith, PhD DO DO read given 'PhD' and family 'DO DO John Smith'? #562), ambiguity reports (Use letter case to disambiguate suffix vs. surname: "Jack MA" vs "Jack Ma" #289, Should a credential run after a comma keep its comma when the last word is an ambiguous acronym? John Smith, PhD MEng reads first PhD, last John Smith #544, Kim Min Do under FAMILY_FIRST is told 'Do' was "read as a middle name" when it lands in the family #626), case repair of credentials (Case repair: letter masks for the exceptions map (phd → PhD, bsc → BSc), md leaves the map, and roman numerals past iv (john smith xi → Xi) #459), initials (rules.md#R3's "a conjunction never initials" is unqualified: Juan de y has base y and initials J. #461, HumanName.initials() re-derives the conjunction decision instead of honoring the parse's tags: john e smith gives j. s. from the facade and j. e. s. from parse() #528).

• Issue links: sphinx.ext.extlinks adds an :issue: role (GitHub redirects /issues/N to /pull/N for PRs). 223 older #N references are converted; the 21 inside bold leads stay plain text, since RST markup does not nest.

• Fixes: a ()#147) typo in the 1.x log, and a bold lead that rendered raw backticks.

• Doc links: 14 bullets end with "See

  ." pointing at the usage/customize section for the behavior or its setting; six headings gain labels for it (trailing-titles, parser-guesses, credentials-also-surnames, connectives-also-initials, dotted-credentials, all-caps-credentials).

• AGENTS.md: the release-log instructions in Commands describe the new bullet shape.

• Summary and highlights: the entry opens with a one-sentence summary and six highlights. Examples use real names and credentials (Jane Smith, PhD MA, LEED AP, N.C.C.), and MA vs Ma is shown on one name (Jack MA / Jack Ma).

• No speed claim: measured on py3.11, ordinary names parse in the same time as 2.3.0 (about 68 µs per name for parse() over 866 corpus names), though each parse makes about 25% fewer calls. The performance bullet now covers only the three quadratic-time fixes.

Test plan

• Every before/after example in the 2.4.0 entry run against the tree, and the summary examples against the 2.3.0 wheel too
• sphinx-build -q -b html and -b doctest print nothing; rendered page has no raw :issue: or **
• uv run pytest tests/v2 -k doc passes

🤖 Generated with Claude Code

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 99.02%. Comparing base (b15393d) to head (9713594).
⚠️ Report is 1 commits behind head on master.

Additional details and impacted files

@@           Coverage Diff           @@
##           master     #646   +/-   ##
=======================================
  Coverage   99.02%   99.02%           
=======================================
  Files          46       46           
  Lines        4513     4513           
=======================================
  Hits         4469     4469           
  Misses         44       44           

☔ 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.