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

[Ezio Melotti]

Ezio Melotti added the comment:

Usually docstrings are short and to the point, and serve more as a remainder, whereas the online docs explain everything in detail.
Also rst markup in docstrings would be distractings, so we keep docstrings and online docs separated, even though there is often some overlapping.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue25461>
_______________________________________