GDP Status ReportThis is the status of the Gentoo Documentation Project. It will be posted regularly, but not with a static frequency. All questions can be posted to gentoo-doc@gentoo.org or to me personally. The Gentoo Documentation Project, from now on abbreviated to GDP, has its own project page (just like almost all other Gentoo projects). You can find it at http://www.gentoo.org/proj/en/gdp. This status mail will briefly discuss the following tasks, objectives and/or projects related to the GDP: 2. New / Updated Documentation The Gentoo Installation Tips 'n Tricks document now has a section on copying over the LiveCD kernel instead of compiling one yourself. The Usermode Linux Guide has been improved with information from various forum postings. Users of cascading profiles might notice some changes to the system packages. The removal of slocate and dhcpcd result in some updates to the Gentoo Handbook, informing the reader to install those packages as well if he needs it. We now have a document on Using NX on Gentoo Linux, thanks to Stuart Herbert. This has been added to the Desktop Documentation. The KDE Configuration Guide has been extended with a FAQ section. This section currently holds one question regarding slow start-up of KDE, a problem many users have reported over the past few months. An overview of all fixed bugreports since the last status update can be found on Gentoo's bugtracking system. 3. Portage Part in Gentoo Handbook The Gentoo Handbook now has a Working with Portage part explaining Portage, Gentoo's Software Management Tool. Also, the Working with Gentoo part has received some updates, such as a new chapter called A Portage Introduction which contains the basic Portage commands every user needs to know. These two parts are written with Portage 2.0.51 in mind. After an interesting thread on the documentation mailinglist, we will be working on two metadata related aspects (which means: important for the documentation developers but barely noticeable by the users at first): First of all, we will extend the GuideXML syntax a bit to allow version/date information inside the individual chapters of the Gentoo Handbook. Up until now, this is handled by the parent index file but this has proven to be a rather difficult working method. Placing this information in the individual chapters we can increase the flexibility towards our translators regarding handbook updates - whereas they previously had to dig through the CVS mailinglist to find the updates, they can now relie on the differences between the versions of individual chapters. The second metadata related project introduces a metadata file which lists all our documentation, both provided by the GDP itself and by the individual projects. This metadata file should be flexible enough to allow automated creation of index files, an improved management of translated files, a track record of Gentoo documentation and much, much more. More about this later. |
|
