Re: [PEAR-DOC] docbook 5 conversion

Arnaud Limbourg wrote:
> Christian Weiske wrote:
>> Hello Brett,
>>
>>
>>> Once we know what other challenges the 4=>5 conversion has in store,
>>> we need to determine the set/book structure we'd like to follow and
>>> get at least one small package set up as an example.
>> I think we should have a book for each single package. This way we have
>> way more methods to integrate and structure documentation, especially
>> the books from Laurent (definitive guides) which are already books.
> 
> Naive questions:
> 
> Won't that complicate building ?

no

> What about the common structure across the documentation ?
> 
> Having a book per package means that any package can do as wished but it
> also means that if the basic structure (which will probably be used by
> 90% of packages changes) changes it will be hell to go over all the
> packages "books" ?

php documentation is now organized into books, and they have no trouble.
 The key is defining a clear structure just as we do now for refsects.

> Will phd be happy with that ?

very happy and so will I :).

books make everything better.  Check out the source for the HTTP
extension in phpdoc/en to see how it could work.  All we need to do is
decide what we want it to look like.

Greg