[New-bugs-announce] [issue35449] documenting objects
Stefan Seefeld
report at bugs.python.org
Sun Dec 9 12:41:42 EST 2018
New submission from Stefan Seefeld <stefan at seefeld.name>:
On multiple occasions I have wanted to add documentation not only to Python classes and functions, but also instance variables. This seems to involve (at least) two orthogonal questions:
1) what is the proper syntax to associate documentation (docstrings ?) to objects ?
2) what changes need to be applied to Python's infrastructure (e.g., the help system) to support it ?
I have attempted to work around 1) in my custom code by explicitly setting an object's `__doc__` attribute. However, calling `help()` on such an object would simply ignore that attribute, and instead list the documentation associated with the instance type.
Am I missing something here, i.e. am I approaching the problem the wrong way, or am I the first to want to use object-specific documentation ?
----------
messages: 331443
nosy: stefan
priority: normal
severity: normal
status: open
title: documenting objects
type: enhancement
_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35449>
_______________________________________
More information about the New-bugs-announce
mailing list