[JarryShaw]

• Searched for similar pull requests
• Followed the coding style (make pylint, make mypy, make isort)
• 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 of your pull request and other information

Turns library-internal names written as literals in rendered prose into roles, such as FrameType.Flags and AppType.get. It also documents what they point at: the missing public classes (CommandType, ConformanceRequirement, ResponseKind, GroupingInformation, Settings, OptionEnumField) and, per the ruling on #1940, the private helpers and special methods that rendered text names. Concepts, layer names, wire fields, extras and historical names stay literals.

docs/source/conf.py gains an attribute getter so :special-members: __new__ documents an enum's own __new__ rather than the enum machinery's. Const docstrings go through their vendor templates. The AppType and OptionType files are left to #1945.

tests/project/test_docs_internal_refs_1940_unit.py pins the entries and a curated set of converted references, and fails without the change. The docs build has no warnings.

Closes #1940

[JarryShaw]

NEEDS CHANGES at d1bb31e8c, two nits. A Sonnet review built the docs on the 3.17.2 pin with -W: 0 warnings. AppType.get and FrameType.Flags link. The __new__ attribute getter is right for stdlib and aenum enums and touches nothing else. Const and template text match, and the new test fails on main (57 failed). Two fixes are going in a follow-up commit. ipv6_ext.rst still carries the unlinked Internet._lookup_next_layer role that the docstring copy already repoints. And two test docstrings use timed wording ("now has", "now written").

[JarryShaw]

GOOD TO GO at 78d68598d. A Sonnet delta review confirmed the new commit touches only the ipv6_ext.rst role, a conf.py docstring and the #1940 test's docstrings. No assertion or curated data changed. The role's new target, ProtocolBase._lookup_next_layer, imports and has an entry on the protocol page. No review-history wording is left in the lines this PR adds. The #1940 and #1919 tests pass, and the docs build with 0 warnings (worker's build).