Author jonash
Recipients docs@python, eric.araujo, jonash, python-dev
Date 2011-05-06.17:26:56
SpamBayes Score 2.54851e-10
Marked as misclassified No
Message-id <1304702816.91.0.0778751980185.issue11977@psf.upfronthosting.co.za>
In-reply-to
Content
It doesn't. Sphinx still can't make any links, which btw also means that it's impossible to reference those methods within the Python documentation.

Also I want to point out that I find the information very hard to find as a human. The fact that integers are based on `numbers.Number` is -- at this point in time where 95% of all Python developers don't know about the `numbers` module or abstract base classes in general -- an implementation detail and as such should not affect the way `int` is documented.

I propose to have decent class references for int, str, ... similar to the reference for dict -- that is, document all attributes and methods in one place and make them referencable. For those who want to deep-dive into CPython internals, a note about those functionality actually being implemented in ABCs could be added.

(But I think that's out of scope for this ticket. I could open a new one if anyone agrees with me... :-)
History
Date User Action Args
2011-05-06 17:26:57jonashsetrecipients: + jonash, eric.araujo, docs@python, python-dev
2011-05-06 17:26:56jonashsetmessageid: <1304702816.91.0.0778751980185.issue11977@psf.upfronthosting.co.za>
2011-05-06 17:26:56jonashlinkissue11977 messages
2011-05-06 17:26:56jonashcreate