[clue-tech] Anyone heard of JAVADoc?

[Johann]

Kevin Cullis wrote:

> This is for the techies of CLUE, has anyone heard of JAVADoc?

JavaDoc allows you to parse your Java source code to build
HTML documentation.

> And if so, how do you like it?

It's cool.  But like *all* documentation, you have to be diligent to keep
it up to date.  The nice thing is that your documentation and source code
are in the same files, so the hypothesis is that this will help alleviate
the lazy programmers to keep documents up to date.  The reality is that the
source code (even undocumented) is more important in the short term whereas
documentation is more important in the long term.  This means that
documentation always will be neglected.

Later
Jeff

--
Protect On-Line Free Speech!
http://www.eff.org/support/joineff.html