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.