<div dir="ltr">Hi,<div><br></div><div>It seems that during the recent suggestions about what markup to choose (Markdown, Creole, Asciidoc, etc.), we've forgotten about one of the goals that seem very important to me for Haskell: the ability to write <b>math formulas</b>. I have experienced on StackExchange that just adding MathJAX to Markdown leads to many surprising errors that can be fixed only by strange hacks.</div>
<div><br></div><div style>Personally I'd incline to choose some existing, well-established markup language with formal specification that supports math (hopefully there is one). Extending Haddock with new features and a syntax for math formulas would certainly require to design such a specification, which isn't easy, and using an existing one would simplify the process a lot. Also I believe that newcomers to Haskell would definitely appreciate working with an existing markup language (and I'm sure not only them) instead of having to learn Haddock's syntax.</div>
<div style><br></div><div style> Best regards,</div><div style> Petr</div><div style><br></div></div><div class="gmail_extra"><br><br><div class="gmail_quote">2013/5/2 Mateusz Kowalczyk <span dir="ltr"><<a href="mailto:fuuzetsu@fuuzetsu.co.uk" target="_blank">fuuzetsu@fuuzetsu.co.uk</a>></span><br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">-----BEGIN PGP SIGNED MESSAGE-----<br>
Hash: SHA1<br>
<div><div class="h5"><br>
On 02/05/13 06:57, Ben wrote:<br>
> sorry, i was only trying to make a helpful suggestion!<br>
><br>
> just to clarify: i'm not championing asciitext (or any other<br>
> format) -- i only heard about it recently in a comment on<br>
><br>
> <a href="http://www.codinghorror.com/blog/2012/10/the-future-of-markdown.html" target="_blank">http://www.codinghorror.com/blog/2012/10/the-future-of-markdown.html</a><br>
><br>
> i checked it out and it sounded cool, so i thought it'd be a<br>
> helpful pointer to whomever is working on new haddock -- they are<br>
> of course welcome to ignore it. totally understand that overmuch<br>
> debate is not helpful (though i'm not sure it's fair to call it<br>
> bikeshedding, since it is a primary feature of the proposed<br>
> project!)<br>
><br>
> best, ben<br>
><br>
> On Apr 27, 2013, at 2:02 PM, Bryan O'Sullivan wrote:<br>
><br>
>> On Sat, Apr 27, 2013 at 1:47 PM, Ben <<a href="mailto:midfield@gmail.com">midfield@gmail.com</a>> wrote:<br>
>> asciidoc has been mentioned a few times in comments, i think it's<br>
>> worth looking at.<br>
>><br>
>> This is the problem I was afraid of: for every markup syntax<br>
>> under the sun, someone will come along to champion it.<br>
>><br>
>> The choice of one or N syntaxes is ultimately up to the<br>
>> discretion of the student, guided by their mentor. It is in our<br>
>> collective interest to avoid prolonging a bikeshed discussion on<br>
>> this, as a long inconclusive discussion risks dissuading any<br>
>> sensible student or mentor from wanting to pursue the project in<br>
>> the first place.<br>
><br>
><br>
> _______________________________________________ Haskell-Cafe<br>
> mailing list <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>
><br>
</div></div>These two posts are exactly why I believe that extending Haddock<br>
itself would be of more benefit than simply adding a Markdown<br>
extension to it: with addition to core features, integrating any of<br>
the N syntaxes that people want suddenly becomes the question of just<br>
writing reader and writer modules for Pandoc instead of a full project<br>
on marshalling yet another markup as an extension directly to Haddock.<br>
<br>
- --<br>
Mateusz K.<br>
-----BEGIN PGP SIGNATURE-----<br>
Version: GnuPG v2.0.19 (GNU/Linux)<br>
<br>
iQIcBAEBAgAGBQJRggwfAAoJEM1mucMq2pqXHmAP/R2nHmXiNHDVqWEAoLQHSNeC<br>
psgcNm2hAclo6AxYprPsNHkqIUYh4HVpsc8FZw+RsAwkpUrGiaaMD/OTNB5857V+<br>
296lzHNOLNvge7B77FfVTa5wx1j2M+N0+pcOzcxr8qX5opfJNOcMPPtaXqD0nMS7<br>
6EsBac/pQAjOHVYOTHEpsxAbl70s/QFBa/kW6tZPJmWKdHp6c3VmL5qx9CY9lZO4<br>
1QKmyKqQMhxN0hmxcFHcYsa/IsohSAFewrs6JDErShn5ffIvtkhEM0UKVCBM26G4<br>
Eu4Hadrv/AyoDT6UdtMgVllzY0XrykfLJ1nXzpp0QklYml0/SMmNrwqO9wfooMfF<br>
XKWiW2T8QWN5dFJO4kM9JA6UqpQ2uvrK6qWREL3jv8/jbEvg0WVko3zTW/BNzjF2<br>
/Pn/9Z1vxYEee4A3Oa0sT7NGhKqK9KRtIgdfuXvTCnctvFYBxwtGHCcKuxgHVNNM<br>
GIJAqMtUtwr1Kjt37Gf0F+r1TBQfOsJL7tzRPayZKYPl7uA/ugrHHnYxL5JqIyAq<br>
bMUqLxAsDNW2tXIPzmNi4QYPqaopaUmwAD8IPvFk9e/1vI0QnU8b1URLjt5zl3O+<br>
mFyWYTQd/UuaFOmOEmfLMJz+n2tRqL51LOCYcHwEjpH10WuTpX1DS3LWErcwppO5<br>
bUZggQ5DwewgRIfCNEfS<br>
=nnP/<br>
-----END PGP SIGNATURE-----<br>
<div class="HOEnZb"><div class="h5"><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>