Message332717
> Double spaces between sentences increase readability. This is not a bug.
hmm ok. I can see other docstring with not double spaces. But I will ignore.
> Since abstractclassmethod and like are deprecated and should not be used in new code, I do not see a value of extending their docstrings.
Ok, you are right.
> Too verbose docstrings make using the module help less convenient. I would rather remove existing examples from docstrings. The module documentation contains more modern examples.
Do you say that is convenient remove the examples? I can do it! But in defense of the examples on docstring I think those are good, because the are the most quickly reference when coding and those are use by IDE. |
|
Date |
User |
Action |
Args |
2018-12-29 13:51:00 | eamanu | set | recipients:
+ eamanu, docs@python, serhiy.storchaka |
2018-12-29 13:50:58 | eamanu | set | messageid: <1546091458.56.0.0967322741102.issue35609@roundup.psfhosted.org> |
2018-12-29 13:50:58 | eamanu | link | issue35609 messages |
2018-12-29 13:50:58 | eamanu | create | |
|