<br><br><div class="gmail_quote">On Tue, Sep 20, 2011 at 14:56, Gael Varoquaux <span dir="ltr">&lt;<a href="mailto:gael.varoquaux@normalesup.org">gael.varoquaux@normalesup.org</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">

<div class="im">On Tue, Sep 20, 2011 at 11:41:44AM -0700, Fernando Perez wrote:<br>
&gt; On Fri, Sep 16, 2011 at 8:44 PM, Gael Varoquaux<br>
&gt; &lt;<a href="mailto:gael.varoquaux@normalesup.org">gael.varoquaux@normalesup.org</a>&gt; wrote:<br>
<br>
&gt; &gt; It seems to me wrong to go with any other markup language, given that the<br>
&gt; &gt; standard in the Python world in reST. It is hard enough to agree on<br>
&gt; &gt; standards, let us rejoice that there is one.<br>
<br>
&gt; I would have hoped for less of a cheap shot coming from you.<br>
<br>
</div>I am a bit saddened that you call this a cheap shot. I am giving a user&#39;s<br>
point of view that differs from your developper&#39;s point of view, but is<br>
definitely a point of view many people will have.<br></blockquote><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;"><div class="im"><br>
&gt; We&#39;ve explained (I said it many times at Euroscipy, with lots of<br>
&gt; detail)  that there are *technical* reasons why we weren&#39;t able to put<br>
&gt; reST/shpinx integration into the notebook from day one, despite all of<br>
&gt; us desperately wanting it.  We&#39;ve heard of sphinx before, believe it<br>
&gt; or not.<br>
<br>
</div>When I was working at Enthought, in such a situation, Eric Jones would<br>
tell me that I am letting a technical difficulty force a user interface<br>
decision (he had a good sentence for that, but I can&#39;t remember it). Of<br>
course, it&#39;s a tradeoff: you can put the cost on the developer, or on the<br>
user. Depending on your target audience and the size of your development<br>
team, you choose the right compromise in the tradeoff space.<br>
<br>
I still expect that you will get this question many times, just like when<br>
I work with people that I new to Python, they keep asking me why Python<br>
cannot reload modules reliably. This is not the end of the world, but I<br>
do think that it helps to think about usability when make core choices,<br>
and of course balance them with the other parts of the equation. I cannot<br>
make choices for you.<br></blockquote><div><br></div><div><div>Yes, many Python people will want rST instead of markdown, and they will get it - but not like the markdown cell is done right now, with nice, responsive single-cell rendering in the browser.  We have actually made this choice with user experience in mind. The design of the language makes rST a very bad choice for light interactive text cells, and when we implement rST support, it should be for full-document formatting, where rST&#39;s advantages can shine.</div>

<div><br></div><div>For instance, if you have a header in a text cell, would you expect that your formatting, links, etc. be consistent throughout the document, or independent on a per-cell basis?  It makes sense from an rST perspective that you would want your header levels to be respected across cells.  However, since rST simply interprets the first header-style it sees as h1, the second as h2, etc. this means that the only reasonable option is to rerender all cells together every single time - cells *cannot* be rendered independently. That, combined with rST performance, means that the interactive user experience we want is simply not achievable.  It is simply the wrong tool for the job, from a user-experience perspective.  When we do use rST, it will format the cells all together, in order to preserve the scope behavior that rST writers expect.  Choosing rST will mean forfeiting some quality of the interactive experience for the more powerful tool.  We *will* support it, but in an appropriate manner that actually benefits from rST&#39;s advantages over md.</div>

<div><br></div><blockquote class="gmail_quote" style="margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0.8ex; border-left-width: 1px; border-left-color: rgb(204, 204, 204); border-left-style: solid; padding-left: 1ex; ">

</blockquote></div><div>-MinRK</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<br>
Cheers,<br>
<font color="#888888"><br>
Gael<br>
</font></blockquote></div><br>