On Wed, 2004-08-04 at 07:40, David Nedrow wrote:
I've begun a document that details how to create a boot floppy
for
Fedora installs on systems that don't have CD-ROM drives, etc.
Several people suggested I participate in the docs list to see about
adding it into the doc stream.
It's already in Docbook XML format, since that's what we do all of our
documentation in at work.
This looks great so far. I'll be happy to offer an edit of the XML; I
like to give patches in a useful format. :)
Several people have already contributed additions, including a script
to
pretty much handle the gruntwork automatically.
I'm including a text transform of the first draft.
I haven't lloked at the Fedora doc guidelines yet, but if I remember
correctly they're pretty straightforward, so it should be relatively
easy for me to jimmy things around if necessary.
It's pretty straightforward. You should be able to grab the example
from CVS, read the bug report, and jimmy your document into the
structure. Here are some more useful details:
http://fedora.redhat.com/participate/documentation-guide/ch-tutorial.html -- current best
description of how to layout a tutorial. It is a little dated, and there are several bugs
in it (e.g. the DocBook version at the top should be 4.2) ...
To view all the open Fedora docs bugs, and thereby understand what to do
differently, I'll post the huge URL below[1]. You can also find it as a
link on
http://fedora.redhat.com/projects/docs/ midway down the page
called "All open bugs for fedora-docs".
Also on the Fedora docs project webpage are instructions for grabbing
modules from CVS. You'll want fedora-docs/example-tutorial and
fedora-docs/common.
This bug has some useful fixes to the example-tutorial.
http://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=128903 .
I recently proposed some common entities to be found in
fedora-docs/common/fedora-entities-en.xml ... you'll need to apply this
convention yourself, it's not part of the proper CVS yet. I presume
that it's going to be used, but I'm only speaking for myself on this
one. This is the start of that thread on the list:
http://redhat.com/archives/fedora-docs-list/2004-July/msg00046.html
hth - Karsten
[1]
http://bugzilla.redhat.com/bugzilla/buglist.cgi?short_desc_type=allwordss...
--
Karsten Wade, RHCE, Tech Writer
a lemon is just a melon in disguise
http://people.redhat.com/kwade/
gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41