[Doc-SIG] epydoc reST markup for stdlib docstrings
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...
Size: 836 bytes
Desc: not available
More information about the Doc-SIG