[Doc-SIG] epydoc reST markup for stdlib docstrings

Fred Drake fdrake at acm.org
Wed Apr 14 17:24:21 CEST 2010

On Wed, Apr 14, 2010 at 11:13 AM, Ralf Gommers
<ralf.gommers at googlemail.com> 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.

All consumers of docstrings are programmers.  Maybe only by necessity,
but they are.

Frankly, terminals and any other window just can't handle all that
much text on the typical horizontal monitor, placing a premium on
vertical whitespace.

Widescreen is good for movies, but sucks for general-purpose computer monitors.


Fred L. Drake, Jr.    <fdrake at gmail.com>
"Chaos is the score upon which reality is written." --Henry Miller

More information about the Doc-SIG mailing list