<div dir="ltr"><div>I see the pluggable markup being pushed in this thread again.<br><br>I just want to remind everybody that we currently have a flavor of a markup issue on github.<br><br>The ghc source code uses literal haskell, and it does not work well on github.<br>
<br><a href="http://www.haskell.org/pipermail/ghc-devs/2013-April/001099.html">http://www.haskell.org/pipermail/ghc-devs/2013-April/001099.html</a><br><br>Any markup that is not widely supported makes it harder for third parties to support and parse.<br>
<br></div><div>The solution is *not* to reimplement github in haskell, but to standardize markup as much as possible.<br></div><div><br>Pluggable markup makes the probability that a github-like service, IDEs and similar can make use of the documentation arbitrarily close to zero.<br>
<br><br></div><div>Alexander<br></div><div><br></div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Mon, Apr 29, 2013 at 8:04 AM, Richard A. O'Keefe <span dir="ltr"><<a href="mailto:ok@cs.otago.ac.nz" target="_blank">ok@cs.otago.ac.nz</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">I should add that as a consumer of Haddock documentation<br>
I can testify that fancier styling (in whatever format)<br>
would be of little benefit to _me_. What I need is more<br>
plain text and more examples.<br>
<br>
To be perfectly honest, most of the time when looking at<br>
a Haddock page, I end up clicking on the Source button<br>
because there are things I need to know that are in the<br>
source but not the documentation.<br>
<br>
So I do agree that markup that doesn't get in the way of<br>
a _reader_ who is looking at the source code is an excellent<br>
thing.<br>
<br>
I say this as someone who had to read some Java today and<br>
ended up stuffing it through a comment stripper so that I<br>
could easily find what I needed to find.<br>
<br>
This thread is not about the "visually lightweight" aspect of<br>
Markdown. That's a good thing. No argument there.<br>
<br>
The thread is about how well documented the notation should be.<br>
<div class="HOEnZb"><div class="h5"><br>
<br>
_______________________________________________<br>
Haskell-Cafe mailing list<br>
<a href="mailto:Haskell-Cafe@haskell.org">Haskell-Cafe@haskell.org</a><br>
<a href="http://www.haskell.org/mailman/listinfo/haskell-cafe" target="_blank">http://www.haskell.org/mailman/listinfo/haskell-cafe</a><br>
</div></div></blockquote></div><br></div>