Author eric.araujo
Recipients docs@python, eric.araujo, ezio.melotti, georg.brandl, jonash, python-dev
Date 2011-05-06.17:31:57
SpamBayes Score 3.89331e-07
Marked as misclassified No
Message-id <1304703118.18.0.963403063153.issue11977@psf.upfronthosting.co.za>
In-reply-to
Content
> 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.
Not really: int is not based on numbers.Number, but the ABC serves as documentation.

> 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.
Hum, I think this should be fixed, but not with tons of text containing duplicated information (once for int, once for long, once for float...)  Ezio: you recently fixed a similar problem with collections ABCs methods; what’s your opinion here?
History
Date User Action Args
2011-05-06 17:31:58eric.araujosetrecipients: + eric.araujo, georg.brandl, ezio.melotti, jonash, docs@python, python-dev
2011-05-06 17:31:58eric.araujosetmessageid: <1304703118.18.0.963403063153.issue11977@psf.upfronthosting.co.za>
2011-05-06 17:31:57eric.araujolinkissue11977 messages
2011-05-06 17:31:57eric.araujocreate