[Haskell-cafe] [haskell-cafe] Some reflections on Haskell
doug at cs.dartmouth.edu
Wed Feb 15 03:58:50 CET 2012
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.
More information about the Haskell-Cafe