Re: [PEAR-DOC] docbook 5 conversion

[email protected] (Arnaud Limbourg)
Newsgroups php.pear.doc
Message-ID <[email protected]>
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 ?

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" ?

Will phd be happy with that ?

What about having one book for the documentation and create another 
repository for guides/tutorials/you-name-it where people could put whole 
docbooks.

-- 
Arnaud.
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.