Serhiy Storchaka added the comment: > 1. Most data attributes cannot have individual docstrings, so I expect the > class docstring to list and possibly explain the data attributes.
But almost all PyStructSequence field have individual docstrings. > This does not create a second new class and is not a 'trick'. Thanks for the tip. > I presume that is why property docstrings are not used much. Indeed, only 84 of 336 Python implemented properties have docstrings . However this is even larger percent than for methods (about 8K of 43K). And 100 of 115 PyStructSequence field have docstrings. I think Python should have more docstrings, not less. ---------- _______________________________________ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue16669> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com