Re: Re: API presentation vs API atoms description. Was:

Arnaud Limbourg wrote:

I do think that pearweb suffers from its current completely inflexible layout. One of the best things about tools like phpDocumentor is that if you dislike the layout, you can very easily take an existing template and modify it to create a different one, including re-formatting where information is displayed.

To change that would/will? require a *lot* of work :)

always a stumbling block (understandably).

There is the wiki which is moving forward, the first test version should be available by mid-january. I believe it will help documentation a lot.

with docbook, this is completely impossible without learning an archaic dsssl language that nobody seems to be able to read. It's like the old medieval Catholic masses where the priests spoke in Latin and nobody had any idea what they were saying :).

Docbook layout can also be managed using XSL (not in the current peardoc afaik) and there is livedocs which gives more flexibility.

Yeah, but writing a successful xsl for docbook is a full-time 3 month job that makes me shudder even thinking about it :) Greg