We have been using Doxygen at work for more than one year and it's great, nice HTML etc. but I find the problem not being in the way you document the code: the most important is to have people to realize that documentation is necessary both for them as well as future developers. Working cooperatively is not just to use CVS, is also to provide to your fellow developers means to understand what you write.
Slashdot Mirror
We have been using Doxygen at work for more than one year and it's great, nice HTML etc. but I find the problem not being in the way you document the code: the most important is to have people to realize that documentation is necessary both for them as well as future developers. Working cooperatively is not just to use CVS, is also to provide to your fellow developers means to understand what you write.
Hmmm, if they cancel, or even worse they cut down the project budget I am afraid there will never be job opportunities for geeks up there... sigh!