phpDocumentor

What do you like best?

- Ease of use

- Direct documentation generation from code & source comments visibility

- Direct connection to the class/namespace hierarchy

- I've doung the UML generation feature to be quite useful as we use modeling tools

- Relatively easy configuration even for legacy projects & drop-in support via PHARs (nice!)

- I like the fact that you stand by your code by generating your own docs with PHPDocumentor

What do you dislike?

I've found it a bit hard to control how things are organized in the end result. For e.g. custom ordering of classes/namespaces would be great.

What problems are you solving with the product? What benefits have you realized?

Problems overall:

We have been able to show our in-code documentation externally - to our devepolers or contractors.

We have been able to preview our modeling approach at dev time

We have been able to show/explain architecture to new hires

Benefits:

Helps with modeling

Helps with the on-boarding process

Helps with ensuring that our projects are well documented