I have a big project, that uses CakePHP. Now I would like to create a documentation for other new co-workers.
An idea was to use the existing PHPdoc comments and other comments inside the code to create an automatic documentation for a start.
How can I manage such a big project and How would I create a browsable HTML-Documentation?
-
How can I automatically add missing comments?
(I use Eclipse for coding, but if it is easier in another editor I wouldn't mind.)
There are many functions declared like this:# some explanation not in phpDoc
function whatever() {
....
}
It would be optimal if I could use an external Editor to edit only the phpdoc comments and they were automatically inserted in the sourcecode at the right positions.