[Haskell-cafe] who's in charge?
Daniel Santa Cruz
dstcruz at gmail.com
Sun Oct 31 18:25:40 EDT 2010
> 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
More information about the Haskell-Cafe
mailing list