[Haskell-cafe] [haskell-cafe] Some reflections on Haskell
aristidb at googlemail.com
Wed Feb 15 07:55:49 CET 2012
In the source file, the Haddock documentation is there, no idea why it
doesn't show up.
Am 15.02.2012 04:00 schrieb "Doug McIlroy" <doug at cs.dartmouth.edu>:
> Markus: "What about hoogle/hayoo and hackage?"
> Antoine: "Do you have any links to examples that we should imitate?"
> Hackage is notionally similar to the Java API documentation at
> But Hackage "Documentation" pages typically only give syntax, while Java
> pages invariably summarize semantics. This makes a world of difference.
> The quality of the summaries bespeaks a lot of editorial attention
> above and beyond culling annotations from source code.
> Considerable care has been taken in describing the GHC library at
> but even there one can find absolute mystery entries like
> > It is hard to find one's way in this ecosystm. It needn't be,
> > as Java illustrates. To my mind Java's great contribution to the
> > world is its library index--light years ahead of typical
> > "documentation" one finds at haskell.org, which lacks the guiding
> > hand of a flesh-and-blood librarian. In this matter, it
> > seems, industrial curation can achieve clarity more easily than
> > open source.
> Haskell-Cafe mailing list
> Haskell-Cafe at haskell.org
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the Haskell-Cafe