[Haskell-cafe] who's in charge?

[Daniel Santa Cruz]

> Talking about documentation in the 3rd year software engineering paper I teach,
> I give JavaDoc as an example of what not to do.  I give R as an example of
> something that works quite well.  It's *examples* that make the difference.
>
> One thing I will say for the JavaMail specification is that it has some useful
> examples.

+1 to documentation with some samples.  Back in my PHP days, I used to
love the fact that the PHP docs had not only examples by the
developer, but also comments with examples from the community.

Daniel