[docs] [issue25461] Unclear language (the word ineffective) in the documentation for os.walk

STINNER Victor report at bugs.python.org
Fri Oct 23 09:15:30 EDT 2015


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 <report at bugs.python.org>
<http://bugs.python.org/issue25461>
_______________________________________


More information about the docs mailing list