[Doc-SIG] epydoc reST markup for stdlib docstrings

Barry Warsaw barry at python.org
Wed Apr 14 17:43:49 CEST 2010

On Apr 14, 2010, at 11:13 PM, Ralf Gommers wrote:

>You're a core developer (I think). But for the *average* user, do you really
>think tags are fine? Earlier in this thread there was a mention of people
>that love to read XML. I'm exaggerating a bit of course, but this is
>similar. Whitespace beats tags for readability.

Well, I would think that help output, whether in a terminal or online would
use the raw text to do a nicer job of formatting.  It's source code
readability that concerns me.

-------------- 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/20100414/05147703/attachment.pgp>

More information about the Doc-SIG mailing list