Are python attribute docstrings commonly used?
<p>On the one hand, we are encouraged to just create fields, and not encrust our python classes with extra accessor functions modelled on other languages.</p>

<p>On the other hand, the <a href="http://www.python.org/dev/peps/pep-0224/" rel="nofollow">PEP for 'attribute docstrings'</a> was rejected.</p>

<p>On the third hand, <a href="http://epydoc.sourceforge.net/manual-docstring.html" rel="nofollow">epydoc</a> and <a href="http://sphinx.pocoo.org/ext/autodoc.html#directive-autoattribute" rel="nofollow">sphinx</a> support them. At the risk of a nonconstructive question, is there a single, clear, common practice for documenting variables in classes?</p>
