[docs] [issue11977] Document int.conjugate, .denominator, ...

Ezio Melotti report at bugs.python.org
Sat Dec 24 20:20:37 CET 2011


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Isn't there a way to specify multiple targets for the same entry?
The doc could say that int, float and complex all share some methods/attributes and then either list e.g. int.conjugate, float.conjugate, complex.conjugate with a single description or use just int (or even numbers.Number) and create targets for float and complex too in some other way, so that float.conjugate automatically links to the description of Number.conjugate.
I don't think it's necessary to document all methods/attributes in the same place.  These methods/attributes are not so common, so it's ok to have them documented in the numbers.Number page, for example.  A simple link to the page can then be added to the int/float/complex docs.
See also #4966 for a discussion about the reorganization of the stdtypes page.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue11977>
_______________________________________


More information about the docs mailing list