On 07/27/2018 11:23 AM, boB Stepp wrote: > On Fri, Jul 27, 2018 at 12:50 AM Steven D'Aprano <st...@pearwood.info> wrote: >> >> On Thu, Jul 26, 2018 at 11:34:11PM -0500, boB Stepp wrote: > >>> (1) The author claims that reStructuredText is the official Python >>> documentation standard. Is this true? If yes, is this something I >>> should be doing for my own projects? >> >> Yes, it is true. If you write documentation for the Python standard >> library, they are supposed to be in ReST. Docstrings you read in >> the interactive interpreter often aren't, but the documentation you read >> on the web page has all been automatically generated from ReST text >> files. > > What tool is being used to generate the documentation from the ReST text > files?
I'm not sure if Python is still using it, but Sphinx is a popular choice, originally written to handle the Python docs. _______________________________________________ Tutor maillist - Tutor@python.org To unsubscribe or change subscription options: https://mail.python.org/mailman/listinfo/tutor
