[docs] [issue35609] Improve of abc.py docstring

Emmanuel Arias report at bugs.python.org
Sat Dec 29 08:51:00 EST 2018


Emmanuel Arias <emmanuelarias30 at gmail.com> added the comment:

> 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.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35609>
_______________________________________


More information about the docs mailing list