Skip to content

docs: retire the counted numbers that tests and the python-versions updater pin #1811

Closed

Description

@JarryShaw

Describe the bug
Under the #1103 ruling (no counted numbers in the docs), several docs pages state counts that tests or tools pin, so their prose cannot change without the code:

  • tests/project/test_conventions_doc_claims.py pins the process.rst changelog-entry and section counts, the registry-protocol.rst audit figures, and the helper and sentinel-reference counts.
  • tests/corekit/test_sentinel_exports_unit.py pins the sentinel-convention.rst sentinel tally.
  • tests/project/test_workflows_at_a_glance_1732.py pins the workflow count in workflows.rst.
  • tests/project/test_python_matrix_tiers_1633.py, test_python_versions_1660.py and test_python_versions_update_1660.py pin, and the python-versions updater in util/ rewrites, the leg counts in workflows.rst and releasing.rst.

These figures drift, which is why the pins and the rewriter exist.

Expected behavior
The pinned prose becomes count-free in the same change that retires its pins. Each pin is either deleted or replaced by a check that still guards the underlying fact, for example that every workflow file has a row, without a number in the prose. The updater's count claims go too, while its version claims stay.

Additional context
From the #1103 counted-numbers inventory (frozen main d1f671738, results in the session's /tmp/counts-inventory/). The unpinned counts are prose and belong to #1103's round 3.

Activity

  1. added
    docsPull requests that change documentation only (docs: subject prefix)
    pendingAccepted and unstarted - nobody is on it and nothing blocks it
    on Oct 16, 2026
  2. JarryShaw commented on Oct 16, 2026

    @JarryShaw
    OwnerAuthor

    A worker is on this.

  3. added
    wipWork in flight - a covering PR is open or an agent is actively on it
    and removed
    pendingAccepted and unstarted - nobody is on it and nothing blocks it
    on Oct 16, 2026
  4. removed
    wipWork in flight - a covering PR is open or an agent is actively on it
    on Oct 16, 2026
  5. added this to the PyPCAPKit v1.5 milestone on Oct 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    docsPull requests that change documentation only (docs: subject prefix)

    Projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions