Documenting php code - best way to document a group of includes or requires

Question

Hi just as the title suggests i am looking for the best way to document groups of requires or includes in a php class file. Should each require be documented and are there any phpdoc tags that should be used specifically.

Answer 1

All include and require files should be documented at the top of the file Check out the @category tag to group them together.

Answer 2

There are many documentation tools available. you can try any of them.

JSDoc, phpDocumentor, OraDoclet, doxygen, phpdoc, PHPxRef.

I personally use doxygen or phpDocumentor