Fedora install boot floppy doc

[Karsten Wade]

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=allwordssubstr&component=fedora-docs&bug_status=ASSIGNED&bug_status=MODIFIED&bug_status=NEEDINFO&bug_status=NEW&bug_status=REOPENED&bug_status=VERIFIED&bug_severity=high&bug_severity=low&bug_severity=normal&bug_severity=security&bug_severity=translation&long_desc_type=allwordssubstr&bug_file_loc_type=allwordssubstr&status_whiteboard_type=allwordssubstr&fixed_in_type=allwordssubstr&devel_whiteboard_type=allwordssubstr&keywords_type=allwords&cust_facing=YES&emailassigned_to1=1&emailtype1=exact&emailreporter2=1&emailtype2=exact&bugidtype=include&chfieldto=Now&cmdtype=doit&remaction=run&namedcmd=blank&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop

-- 
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