In the past I have already tried PHPDoc, that has the same goal as Doxygen which is: to build documentation based on the comments you have written in your project code files.

I have never used a documentation generator tool before in a serious/big project, so this is the first time. The adaption process it’s kind of easy, since the comments style that I use in all my projects is very similar to the one we have chosen in Doxygen. It also has a tool named doxywizard that helps you to write Doxygen configuration files easily trough a nice and clean GUI.

Doxygen supports a lot of programming languages, including my favorite (PHP) maybe I’ll use it in my future PHP projects too.

You may take a look at Doxygen at it’s official website.