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

Serhiy Storchaka report at bugs.python.org
Sat Dec 29 02:56:40 EST 2018


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

Double spaces between sentences increase readability. This is not a bug.

Since abstractclassmethod and like are deprecated and should not be used in new code, I do not see a value of extending their docstrings. 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.

----------
nosy: +serhiy.storchaka

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


More information about the docs mailing list