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
