Re: Online doc generator (Was: Re: [PEAR-DEV] Amsterdam meeting agenda)

On Apr 12, 2004, at 6:16 PM, Paul M Jones wrote: <snip>

Don't get me wrong, I am very open to alternatives but I am not aware of any reliable alternative at the moment.

That's why we need to do requirements determination. Your "reliable" may not be the consensus "reliable" (just for starters). I am sorry but I just expressed my opinion. I am a mere volunteer and I never pretended that my "reliable" reflects the views of the majority.

Step 2 will be to figure out what meets the requirements. Wiki might, DocBook might, ReST might, New Silver Bullet X might. But requirements first! DocBook is not a "requirement", it is a technology solution, same as Wiki or anything else.

As I said, I just expressed my views. I am just a volunteer trying to help with Docs, I am not a core, or a group member. One of the main arguments (for me) to stay with DocBook is that all the time invested to migrate the existing Docs to a wiki or something else can be deployed to write either a set of very simple tutorials for developers or some skeleton XML where the lead has just the duty to fill in some of the tags (this is already achievable with PHPDocumentor to some extend) or even better to auto generate some docs with PHPDocumentor. The second argument is that Docbook is used by php.net and I can ask for some help there if needed. Regards David Costa