Paul Jones has written an interesting piece about documentation in the PEAR project, in which he argues very convincingly for using wikis for end user documentation.
I actually think that last point bears repeating: using wikis for end
user documentation. I talked to Paul about this issue at
php|Tropics, and both of us use phpDocumentor quite religiously. However,
API documentation is very different from end user documentation. And the
issue with documentation at the PEAR project has to do with the fact that
there are many projects with little or no end user documentation -- which
often makes it difficult for a developer to determine how a module might be
used.
The often-cited barrier for this is that end user documentation on the PEAR
website must be done in DocBook format.
