Re: [Phpgroupware-developers] Code documentation

[Dan Kuykendall]

Chris Weiss wrote:

> php.net's whole website is in a cvs server, and you can view any pages source 
> via a
> link at the bottom.  it almost looks like the online manual is generated with te
> comments added at teh bottom on each page.  Looking at their doc team how-to 
> they
> use DocBook for everything then have export scripts run in daily batches.

Im fine with using Docbook, since its a well accepted standard, is not 
that hard to learn/use, and can easily convert to a number of formats.
After the last couple of years I am pretty against trying to do the API 
docs with inline comments for the reasons I have stated.

Dan