[Doc-SIG] epydoc reST markup for stdlib docstrings

Barry Warsaw barry at python.org
Wed Apr 14 02:40:47 CEST 2010


On Apr 14, 2010, at 01:30 AM, Michael Foord wrote:

>Definite +1 from me on adopting reST in docstrings as a standard. I 
>haven't looked at the Epydoc convention for parameters (etc) well enough 
>to have an opinion on that.

The thing I like about them is that the rules are very simple, and once
learned are easy to remember.

-Barry
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/doc-sig/attachments/20100413/5730ac3b/attachment.pgp>


More information about the Doc-SIG mailing list