FAQ Guide - split to multiple files

Matt Galvin matt.t.galvin at gmail.com
Wed Aug 10 15:36:13 UTC 2005


On 8/10/05, Matt Galvin <matt.t.galvin at gmail.com> wrote:
> Hi All,
> 
> I would like to split the faqguide into multiple files to make working
> with it a bit easier. Right now it is one monolithic xml file and I
> don't need to explain the benefits of splitting it into smaller files.

Here is my initial proposed structure:

<!ENTITY revhistory SYSTEM "revhistory.xml">
<!ENTITY preface SYSTEM "preface.xml">
<!ENTITY gettingstarted SYSTEM "gettingstarted.xml">
<!ENTITY installing-applications SYSTEM "installing-applications.xml">
<!ENTITY applications SYSTEM "applications.xml">
<!ENTITY games SYSTEM "games.xml">
<!ENTITY hardware SYSTEM "hardware.xml">
<!ENTITY windows-partitions SYSTEM "windows-partitions.xml">
<!ENTITY users-administration SYSTEM "users-administration.xml">
<!ENTITY networking SYSTEM "networking.xml">
<!ENTITY security SYSTEM "security.xml">
<!ENTITY rescue-mode SYSTEM "rescue-mode.xml">
<!ENTITY tips-and-tricks SYSTEM "tips-and-tricks.xml">
<!ENTITY troubleshooting SYSTEM "troubleshooting.xml">
<!ENTITY upgrading-ubuntu SYSTEM "upgrading-ubuntu.xml">

Additionally, the revision history order is backwards. The newest
version info should be on top, this is how apt packages do it. Why is
this doc backwards? I would like to fix this too.

Feedback?

Thanks,

Matt




More information about the ubuntu-doc mailing list