begin quoting Andrew Lentvorski as of Sat, Jun 03, 2006 at 05:35:01PM -0700: > Gregory K. Ruiz-Ade wrote: > >The "use the source, Luke" cliche is, really, a cop-out that developers > >use so that they don't _have_ to properly document. > > So, what is proper documentation, pray tell? > > And how do you keep it synchronized with the code?
Documentation tells you what the code /should/ be accomplishing. The code merely tells you what it _does_. Code that doesn't match the documentation is, by definition, buggy. What do you do when your requirements don't match your deliverable? -- _ |\_ \| -- [email protected] http://www.kernel-panic.org/cgi-bin/mailman/listinfo/kplug-list
