[Tutor] Questions about the formatting of docstrings

boB Stepp robertvstepp at gmail.com
Fri Jul 27 13:23:00 EDT 2018


On Fri, Jul 27, 2018 at 12:50 AM Steven D'Aprano <steve at 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?

Thanks!
boB


More information about the Tutor mailing list