<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
  <meta content="text/html; charset=ISO-8859-1"
 http-equiv="Content-Type">
</head>
<body bgcolor="#ffffff" text="#000000">
On 14/04/2010 17:13, Ralf Gommers wrote:
<blockquote
 cite="mid:m2xdde7764a1004140813w595b79dcuc58d500145a10408@mail.gmail.com"
 type="cite"><br>
  <br>
  <div class="gmail_quote">On Wed, Apr 14, 2010 at 10:56 PM, Michael
Foord <span dir="ltr">&lt;<a moz-do-not-send="true"
 href="mailto:fuzzyman@voidspace.org.uk">fuzzyman@voidspace.org.uk</a>&gt;</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 class="h5">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>
Well, docstrings that take up several screens worth of console and
scroll out of view like merry abandon are horrible. We should do real
usability testing (with 'real' users) if we really want an answer.<br>
<br>
Michael<br>
<br>
<blockquote
 cite="mid:m2xdde7764a1004140813w595b79dcuc58d500145a10408@mail.gmail.com"
 type="cite">
  <div class="gmail_quote">
  <div>Ralf<br>
  <br>
  </div>
  </div>
</blockquote>
<br>
<br>
<pre class="moz-signature" cols="72">-- 
<a class="moz-txt-link-freetext" href="http://www.ironpythoninaction.com/">http://www.ironpythoninaction.com/</a></pre>
</body>
</html>