[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