Guide table and BZ

Ruediger Landmann r.landmann at redhat.com
Wed Jun 3 22:43:47 UTC 2009


Eric Christensen wrote:
> If you haven't updated the Guide Table[1] lately, please take a look 
> at it and see if you can provide any updates.
>
> I'd also like to clean up the Fedora Documentation product in BZ.  
> Currently there are the following components:
>
>     * about-fedora - General project information for main menu.
>     * readme-burning-isos - README for burning ISO images, included at
>       mirrors.
>     * readme-live-image - README for inclusion in Live ISO spins
>     * readme - README file for inclusion in ISO spins
>
I've got versions of the above four documents converted to build in 
Publican, as well as:

* Homepage (we need to make a decision about whether to even keep this 
-- I strongly suggest killing it since it serves no useful purpose, and 
only potentially serves to confuse users)
* Accessibility (which appears to be seriously out-of-date. I've updated 
a number of URLs, but I have no idea whether this document actually 
reflects the current state of accessibility tools in Fedora)

I really don't think that any of these should be packaged with the 
Release Notes as they have been in the past.

I haven't checked any of these into the repo; the Publicanized versions 
will need attention from L10N, and I don't want to touch that until 
Transifex gets updated to version 0.6.

Finally , I plan to produce a "Quick Start" Installation Guide for F12 
to cover the "path of least resistance" for somebody to download Fedora 
and get it installed on a typical PC. This would be the Guide for a user 
who doesn't need the full documentation of the installation process and 
all its options that the IG offers. Some of this Guide will necessary 
overlap somewhat with "readme-burning-isos" and possibly make that 
smaller doc redundant.


Cheers
Rudi




More information about the docs mailing list