<p>In the source file, the Haddock documentation is there, no idea why it doesn't show up.</p>
<div class="gmail_quote">Am 15.02.2012 04:00 schrieb "Doug McIlroy" <<a href="mailto:doug@cs.dartmouth.edu">doug@cs.dartmouth.edu</a>>:<br type="attribution"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Markus: "What about hoogle/hayoo and hackage?"<br>
<br>
Antoine: "Do you have any links to examples that we should imitate?"<br>
<br>
Hackage is notionally similar to the Java API documentation at<br>
<a href="http://www.oracle.com/technetwork/java/javase/documentation/" target="_blank">http://www.oracle.com/technetwork/java/javase/documentation/</a><br>
But Hackage "Documentation" pages typically only give syntax, while Java<br>
pages invariably summarize semantics. This makes a world of difference.<br>
The quality of the summaries bespeaks a lot of editorial attention<br>
above and beyond culling annotations from source code.<br>
<br>
Considerable care has been taken in describing the GHC library at<br>
<a href="http://www.haskell.org/ghc/docs/" target="_blank">http://www.haskell.org/ghc/docs/</a><br>
but even there one can find absolute mystery entries like<br>
<a href="http://www.haskell.org/ghc/docs/latest/html/libraries/haskell98-2.0.0.1/Locale.html" target="_blank">http://www.haskell.org/ghc/docs/latest/html/libraries/haskell98-2.0.0.1/Locale.html</a><br>
<br>
Doug<br>
<br>
> It is hard to find one's way in this ecosystm. It needn't be,<br>
> as Java illustrates. To my mind Java's great contribution to the<br>
> world is its library index--light years ahead of typical<br>
> "documentation" one finds at <a href="http://haskell.org" target="_blank">haskell.org</a>, which lacks the guiding<br>
> hand of a flesh-and-blood librarian. In this matter, it<br>
> seems, industrial curation can achieve clarity more easily than<br>
> open source.<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>
</blockquote></div>