I have been charged with determining a standard for my company for
finding a standard for documenting our code. Actually, I'm new to the
company and have been told that very little is generated so I get to
determine what documentation is acceptable before the current employees
transfer within the company. This means that whatever standard I pick,
I have to be willing to accept the output and then maintain it so my
successor as well.
80~90% of our code is PHP with the remaining balance in Perl. Tools I
have considered so far are:
CHOICE 1: PHPDOC at http://www.phpdoc.de
The original? appears like stagnated several years ago and never grew.
Not really giving it serious consideration unless someone has
compelling reasons otherwise.
CHOICE 2: PHPDocumentor at http://phpdoc.org
What can I say except it appears to the one of the most recommended
tools I have found in research. I am unsure what to expect from it
compared to my third choice.
CHOICE 3: DOXYGEN at http://www.doxygen.org
Been around a long time and doesn't seem like a bad choice. It just
doesn't have the same emphasis on PHP that PHPDocumentor does.
Some of the key points I am looking at personally include:
1) Long term viability of the solution chosen. This could be offset by
the compatibility of the tags with other products.
2) Ease to get existing code documented to the chosen standard
3) Ease to document future code
4) Quality/flexability of the tool chosen
Anyway, which opensource documentation tool do you recommend and why?
Please indicate in responses which you have experience with.
Thanks in advance for the opinions!
Anthony