[JarryShaw]

• Searched for similar pull requests
• Followed the coding style
• make test passes, and a test case covers the change
• Changelog entry: N/A — centralised in docs(changelog): shared 1.5.0 changelog — long-lived, merges last (#610, #616, #617, #618, #620) #657

What is the purpose of your pull request?

• docs — documentation only

---

Description

Part of #1103, round 7. A full read of everything under docs/ except the API pages and the changelog. The one .py file (conf.py) passes the AST guard.

• workflows.rst:
  • The docs-only project-tests cell runs all of tests/project plus the root modules, a half per step (ci(ordering): shard the project ordering leg and cache the tier guard's workflow parse (#2254) #2258).
  • Project pins skip a docs-only diff.
  • run_unittest_leg.py runs once per cell, and once per half in project-tests.
  • The unsourced "about 6 min" estimate is restated, since no sharded push run had finished.
  • The release-script pins and the CodeQL passage are in present tense.
• protocol-layer-placement.rst: FTP_DATA subclasses Raw alone, so its layer is None; the example now uses a class naming both bases.
• test-coverage.rst: HIP_COPIES is restated as behaviour; it is 1.
• registry-protocol.rst and conf.py: the audit-table rows and two hook docstrings are restated as behaviour. The extlinks comment is scoped to the citations it covers.
• Tests: docs tests, test_conventions_doc_claims, test_codeql_config_2130, the 1967 script tests and the light-PR and pins tests pass. No text pins.

[JarryShaw]

Review: GOOD TO GO at 5562ab0f2 (Sonnet).

• Prose only: the conf.py AST guard is identical.
• Claims: each claim checked against the workflow and code holds:
  • Run the project pins skips on docs-only;
  • project-tests runs --half 1 and --half 2;
  • run_unittest_leg.py runs once per cell;
  • FTP_DATA.__layer__ is None, while a class naming both bases reports Application;
  • HIP_COPIES = 1 (HIP parameter padding aligns the contents, not the record, so every parameter pcapkit emits is 4 (mod 8) octets #651);
  • FEATCode.get folds case and Method.get doesn't;
  • the hook docstrings match the hooks.
• Tests: the workflow readers, conventions, tier guard and docs tests give 792 passed. No text pins.

[JarryShaw]

Ready to merge at 5562ab0f2. Part of #1103, round 7: the non-API docs.

• Review: Sonnet GOOD TO GO.
• CI: all checks complete, Required checks passed SUCCESS, 0 failed. Sync Status is board sync, not CI.
• KTLO: no warnings.
• Ordering: merged into main and run. project leg: 2402 tests, 0 failures.
• Conflicts: none against the current main.