[Haskell-cafe] Documentation (was: ANN: text 0.5, a major revision of the Unicode text library)

[Derek Elkins]

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
> redundant.
>
> Silly really, considering programmers are (allegedly:) intelligent.

Apparently, programmers like programming better than reading as
well... in my experience.