[Doc-SIG] epydoc reST markup for stdlib docstrings

[Michael Foord]

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...

Michael


>
>    -Fred
>
>    


-- 
http://www.ironpythoninaction.com/