Hosting Doxygen docs (Re: [sldev] Doxygen & Comments)

Jason Giglio gigstaggart at gmail.com
Thu Jun 7 12:42:02 PDT 2007


Nicholaz Beresford wrote:
> Usually, in my experience, when you put notes
> and codes in different places, what you get quite
> quickly are two things entirely out of sync.

One of the major principles of good language and program design is that 
related things should be close to each other in the file and application.

Putting comment-type documentation all the way in some external wiki is 
probably the worst thing you could do to violate this design rule.

-Jason


More information about the SLDev mailing list