[Doc-SIG] epydoc reST markup for stdlib docstrings
fuzzyman at voidspace.org.uk
Wed Apr 14 17:25:45 CEST 2010
On 14/04/2010 17:24, Fred Drake wrote:
> 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.
They're great if you turn them sideways though...
More information about the Doc-SIG