On Sat, Aug 06, 2011 at 03:11:05PM +0200, Baptiste MATHUS wrote: > And by the way, documentation is cool. > But even better is look for real-life example. And what's cool with > opensource is that it's easy to find a bunch of examples from simple to very > complex.
Just because X worked for someone sometime doesn't mean it will work for someone else in a different environment, or that it was meant to work that way and will continue to work. An example could be a fluke; documentation is a promise. Good documentation also explains *why* something works, so that you can more readily think about similar problems in context. It imparts knowledge, not just a datum. What's cool about open source is that, when the documentation is useless and the examples are all unexplained magic, I can go read the source and find out what's actually going on. And then I can fix the documentation. -- Mark H. Wood, Lead System Programmer [email protected] Asking whether markets are efficient is like asking whether people are smart.
pgpYnPYiREnFe.pgp
Description: PGP signature
