> 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 _______________________________________________ Haskell-Cafe mailing list Haskell-Cafe@haskell.org http://www.haskell.org/mailman/listinfo/haskell-cafe