René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Invalid class description of set/frozenset in docs","articleBody":"The ``class`` sphinx directive is used (see [it's docs](https://www.sphinx-doc.org/en/master/usage/domains/python.html#directive-py-class)), but wrongly:\r\nhttps://github.com/python/cpython/blob/6313cdde58f34648a430d2830357c9d2a5b67b87/Doc/library/stdtypes.rst#L4251-L4258\r\nIt looks (despite this seems to be not documented in sphinx-doc), that the second signature takes precedence and methods below could be referenced (either internally in CPython or with the intersphinx for external projects) only like ``frozenset.foo``, which is especially silly in cases like ``frozenset.add``.\r\n\r\nWe could mitigate this by reordering set and frozenset in the ``class`` directive (references to set's methods are more common), but this is not a real solution.\r\n\r\nOne option to solve the problem is using two ``class`` directives (like for list/tuple).  BTW, while technically the set is not a subtype of the frozenset, in fact it just has some overloaded ops and a bunch of new methods...\r\n\r\nAnother option is a new sphinx directive like ``currentmodule``: \"Directive `currentclass` (similar to `currentmodule`) would help us.\"  _Originally posted by @serhiy-storchaka in https://github.com/python/cpython/issues/114280#issuecomment-1900305597_\r\n\r\nFinally, it could be viewed as a sphinx-only issue: the class directive must support references for every declared signature (i.e. both ``set.add`` and ``frozenset.add``).","author":{"url":"https://github.com/skirpichev","@type":"Person","name":"skirpichev"},"datePublished":"2024-01-20T02:50:48.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":7},"url":"https://github.com/114336/cpython/issues/114336"}