<div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr">Hello,<div><br></div><div>I am trying to understand the relationship between the Python standard library docstrings and the online documentation.</div><div><br></div><div>For example, it does not appear that <a href="https://raw.githubusercontent.com/python/cpython/master/Doc/library/collections.rst">https://raw.githubusercontent.com/python/cpython/master/Doc/library/collections.rst</a> is a strict superset of the docstrings in <a href="https://github.com/python/cpython/blob/master/Lib/collections/__init__.py">https://github.com/python/cpython/blob/master/Lib/collections/__init__.py</a></div><div>and I do not see any indication that docstrings are automatically extracted anywhere, nor any comment as to why or why not.</div><div><br></div><div>Is there a standing decision *not* to use, say, sphinx-apidoc or sphinx.ext.autodoc? If so, can you point me to an explanation of how the benefits of fully human-maintained documentation outweigh the convenience and consistency of automation?</div><div><br></div><div>In other words, is this an affirmative policy decision that other projects should be guided by, or an accident of history with a lesson to be learned?</div><div><br></div><div>Is there a document that clarifies the role of the standard library docstrings, and what belongs there versus in cpython/Doc/library? Maybe there is a PEP I haven't noticed?</div><div><br></div><div>I hope my question is not too open-ended for this list, but I would also welcome replies off list.</div><div><br></div><div>Thank you for your time,</div><div>Eric</div></div></div></div></div>