René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"token module documentation is incomplete","articleBody":"# Documentation\n\nThe [`token` docs](https://docs.python.org/3/library/token.html) use a generated list of tokens, with short blurbs for the OP tokens but nothing for the other (more interesting) ones.\nSome tokens (`COMMENT`, `NL`, etc.) have secondary, hand-written definitions. However, these are excluded from the index; [links](https://docs.python.org/3/library/token.html#token.COMMENT) go to the empty entries.\n\nI propose adding hand-written prose for the non-OP tokens, and changing the automation to *check* the entries rather than generate them.\nFor the OP tokens, generating the docs is the correct thing to do, but the list can be more compact since they're all the same.\n\n\u003c!-- gh-linked-prs --\u003e\n### Linked PRs\n* gh-130588\n* gh-131465\n* gh-132304\n* gh-132327\n\u003c!-- /gh-linked-prs --\u003e\n","author":{"url":"https://github.com/encukou","@type":"Person","name":"encukou"},"datePublished":"2025-02-26T15:37:02.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":3},"url":"https://github.com/130587/cpython/issues/130587"}