Message177592
> 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. |
|
Date |
User |
Action |
Args |
2012-12-16 12:08:03 | serhiy.storchaka | set | recipients:
+ serhiy.storchaka, rhettinger, terry.reedy, giampaolo.rodola, eric.snow |
2012-12-16 12:08:03 | serhiy.storchaka | link | issue16669 messages |
2012-12-16 12:08:03 | serhiy.storchaka | create | |
|