[Haskell-cafe] Documentation (was: ANN: text 0.5,
a major revision of the Unicode text library)
iainspeed at gmail.com
Sun Oct 11 09:55:10 EDT 2009
On 11 Oct 2009, at 13:58, John Lato wrote:
> For anyone writing introductions to generic programming, take this as
> a plea from Haskellers everywhere. If one of the RWH authors can't
> understand how to make use of these techniques, what hope do the rest
> of us have?
> John Lato
> P.S. Some might wryly note that I'm the maintainer of a package which
> is also known for incomprehensible documentation. To which I would
> reply that our effort is much newer, I consider it a problem, and it's
> being worked on, contrasted to the state of GP where similarly
> impenetrable documentation has been and continues to be the norm.
You could say that about most documentation (for Haskell and beyond).
Apparently, programmers like programming better than documenting. The
effect of this is that less people use their programming, making
their efforts redundant.
Silly really, considering programmers are (allegedly:) intelligent.
More information about the Haskell-Cafe