On Sat, Jun 03, 2006 at 05:35:01PM -0700, Andrew Lentvorski wrote: > 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? >
At the least, programmers notes with a discussion of overall architecture, which files hold which functionality, a HOWTO on adding procedures. And the code still needs good comments within. Don't start me on SCM. -- Lan Barnes Linux Guy, SCM Specialist Tcl/Tk Enthusiast -- [email protected] http://www.kernel-panic.org/cgi-bin/mailman/listinfo/kplug-list
