[Haskell-cafe] Documentation (was: ANN: text 0.5, a major
revision of the Unicode text library)
derek.a.elkins at gmail.com
Sun Oct 11 23:31:53 EDT 2009
On Sun, Oct 11, 2009 at 8:55 AM, Iain Barnett <iainspeed at gmail.com> wrote:
> 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
> Silly really, considering programmers are (allegedly:) intelligent.
Apparently, programmers like programming better than reading as
well... in my experience.
More information about the Haskell-Cafe