Message135343
| 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.8933123e-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? |
|