Skip to content

docs(conventions): ContentType, the ToS registries and SeedID re-case names that registry-protocol.rst says keep the registrar's casing #2565

Closed

Description

@JarryShaw

From the 2026-11-01 conventions audit, re-verified on 73add05a3. registry-protocol.rst, "RFC-Directed Case Sensitivity" and the int-tier paragraph: a member name "preserves the registrar's casing exactly", and a registry's spelling is never quietly normalised. These crawlers re-case:

  • pcapkit/vendor/tls/content_type.py ContentType.clean_name lower-cases, so IANA's ACK (26) is ContentType.ack. Its docstring gives the basis (RFC 9147 §4.1 writes ack); the page has no entry for it.
  • pcapkit/vendor/ipv4/tos_del.py, tos_thr.py, tos_rel.py and pcapkit/vendor/ipv6/seed_id.py call self.rename(...).upper(): the hand-typed DATA labels 'Normal', 'High', 'Low' become NORMAL, HIGH, LOW, and 'IPv6 Source Address' becomes IPV6_SOURCE_ADDRESS. The sibling tos_pre.py keeps its casing (Network_Control).
  • Probe: git grep -n "\.upper()" -- pcapkit/vendor/ipv4/tos_thr.py pcapkit/vendor/ipv6/seed_id.py.

Fix: record each as an exception on the page with its basis: ContentType, RFC 9147 §4.1; the ToS and SeedID labels come from the crawler's own DATA, so they are the project's spelling, not a registrar CSV's. A rename is observable to callers, so this is a page edit.
Blocked: #2521 edits registry-protocol.rst; unblocks when it merges (gh pr view 2521 --json state -q .state prints MERGED).

Activity

  1. added
    docsPull requests that change documentation only (docs: subject prefix)
    blockedDeferred pending another issue or decision; see the last comment for what unblocks it
    on Nov 1, 2026
  2. moved this to Blocked in PyPCAPKiton Nov 1, 2026
  3. JarryShaw commented on Nov 1, 2026

    @JarryShaw
    OwnerAuthor

    Unblocked: #2521 merged, so registry-protocol.rst is free. Dispatched together with the page's other queued fixes (#2551, #2552, #2553, #2556, #2565) as one worker and one PR.

  4. added
    wipWork in flight - a covering PR is open or an agent is actively on it
    and removed
    blockedDeferred pending another issue or decision; see the last comment for what unblocks it
    on Nov 1, 2026
  5. moved this from Blocked to WIP in PyPCAPKiton Nov 1, 2026
  6. removed
    wipWork in flight - a covering PR is open or an agent is actively on it
    on Nov 1, 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

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions