<br><br><div class="gmail_quote">On Wed, Apr 14, 2010 at 11:22 PM, Michael Foord <span dir="ltr"><<a href="mailto:fuzzyman@voidspace.org.uk">fuzzyman@voidspace.org.uk</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
<div bgcolor="#ffffff" text="#000000"><div><div></div><div class="h5">
On 14/04/2010 17:13, Ralf Gommers wrote:
<blockquote type="cite"><br>
<br>
<div class="gmail_quote">On Wed, Apr 14, 2010 at 10:56 PM, Michael
Foord <span dir="ltr"><<a href="mailto:fuzzyman@voidspace.org.uk" target="_blank">fuzzyman@voidspace.org.uk</a>></span>
wrote:<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<div bgcolor="#ffffff" text="#000000">
<div>
<div>On 14/04/2010 16:48, Ralf Gommers wrote:<br>
<blockquote type="cite">
<div class="gmail_quote">
<div><font color="#888888">The vertical whitespace vs tags is a
taste issue, I agree, from a
developer perspective. From a user perspective however, the numpy
standard is clearly more readable in a terminal. That's why it looks
the way it does. And reading docstrings in a terminal is not a fringe
use case by the way.<br>
</font></div>
</div>
</blockquote>
</div>
</div>
I would say that reading docstrings in a terminal is the *main* use
case - but that is why I tend to value the vertical space highly and
personally prefer the less verbose way.<br>
</div>
</blockquote>
<div><br>
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.<br>
<br>
</div>
</div>
</blockquote>
<br></div></div>
Well, docstrings that take up several screens worth of console and
scroll out of view like merry abandon are horrible.</div></blockquote><div><br>In many cases yes, but that is a totally different issue. The example Nick posted was 17 lines for numpy standard vs 15 lines for epydoc standard. <br>
<br></div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;"><div bgcolor="#ffffff" text="#000000"> We should do real
usability testing (with 'real' users) if we really want an answer.<br>
<br></div>
</blockquote></div>That sounds like a good idea.<br><br>Cheers,<br>Ralf<br><br>