I honestly haven't looked at the XML source for the Gentoo documentation so if you guys are already doing this then ignore me.
While reading through some of the post on this mailing list, I thought of a way the docs could be made more manageable and flexible. Use XInclude to break up the XML sources into individual components. i.e. Put each chapter/section of a doc in a separate file and then use XInclude in a `master' XML document to pull everything together. There are many advantages to this. One is that each section can be worked on by a different person and merging changes becomes effortless. No need to worry about wiping out the changes someone else made to the docs as long as they are not working on the same section. Say for instance you have a section in one of the docs that talks about LILO or GRUB but you also want to have that same information in another doc. If the section on LILO or GRUB is in a separate file, adding that information to the other doc is a easy as using XInclude. No need to maintain the information in two separate files and keep them in sync. If you decide that a section of a document should be its own standalone doc, apply a stylesheet to it and voil�! There are other advantages that I'm sure you can think of. -- [email protected] mailing list
