Skip to content

docs: restart reference numbering per section - #153

Merged
jgoldfoot merged 1 commit into
mainfrom
fix-reference-numbering
Aug 3, 2026
Merged

docs: restart reference numbering per section#153
jgoldfoot merged 1 commit into
mainfrom
fix-reference-numbering

Conversation

@jgoldfoot

Copy link
Copy Markdown
Owner

Problem

The whitepaper's reference list was left half-migrated across three different numbering schemes:

Section Numbering
Primary Research 1-19
Agent Protocols 1-5 (restarts)
Rendering & Performance 10-13
Standards 14-18

The list originally ran as one continuous sequence split under headings, which is why Rendering & Performance began at 10 and Standards at 14. A later edit renumbered Agent Protocols to restart at 1 but did not update the two sections after it, so those two now continue a sequence that no longer exists.

This predates the 7/21 and 7/28 research scans (#143, #146).

Fix

Restart Rendering & Performance (1-4) and Standards (1-5) so every section is numbered independently, matching what Agent Protocols already does.

Why renumbering is safe

The body cites references by name and arXiv ID, never by number — grep -cE '\[[0-9]{1,2}\]' docs/whitepaper.md returns 0, and there are no "see reference N" constructions. The markers are purely ordinal, so nothing cross-references them.

The README needs no equivalent change; its reference section uses bullets, not numbers.

Verification

  • npx prettier@3.9.6 --check clean repo-wide
  • npm test — 122 passed, 7 suites
  • Content unchanged; only list markers and their continuation indents

The reference list was left half-migrated. It originally ran as one
continuous sequence split under headings, so Rendering & Performance
started at 10 and Standards at 14. A later edit renumbered Agent Protocols
to restart at 1 without updating the two sections after it, leaving three
different numbering schemes in one list: 1-19, 1-5, then 10-13 and 14-18
continuing a sequence that no longer exists.

Restarts Rendering & Performance (1-4) and Standards (1-5) to match Agent
Protocols. No cross-references break: the body cites references by name and
arXiv ID, never by number, so these markers are purely ordinal.
@jgoldfoot
jgoldfoot merged commit 13fe228 into main Aug 3, 2026
16 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant