Re: epydoc reST markup for stdlib docstrings
Michael Foord <[email protected]>
| Newsgroups | gmane.comp.python.documentation |
|---|---|
| Message-ID | <[email protected]> |
On 14/04/2010 17:24, Fred Drake wrote: > On Wed, Apr 14, 2010 at 11:13 AM, Ralf Gommers > <[email protected]> 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/ _______________________________________________ Doc-SIG maillist - [email protected] http://mail.python.org/mailman/listinfo/doc-sig