STINNER Victor added the comment:

"Also rst markup in docstrings would be distractings, so we keep docstrings and 
online docs separated, even though there is often some overlapping."

Ah yes, and the doc in Doc/ directory contains more information like ".. 
versionchanged:: (...)", ".. versionadded:: (...)", links to other doc using 
reST markups, etc.

In general, the doc in Doc/ is higher quality than docstrings ;)

----------

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue25461>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to