Red Hat Bugzilla – Bug 129911
Fedora Installation Guide
Last modified: 2007-04-18 13:10:24 EDT
Started a discussion on the list about doing an Installation Guide (IG):
Tammy has a good sounding plan for doing a modular IG:
1. Create a ToC for the mailing list to discuss
2. Create empty files in CVS based on the ToC
3. People can volunteer to:
- write one or more sections or chapters
- take screenshots
- QA and edit
Thinking in terms of multiple-architecture support is a good idea.
For example, we can use DocBook conditionals that allow you to mark a
<para> as being only included for certain criteria such as
architecture. For example, if the build for the IBM S390/zSeries
requires some special tricks to get to the first screen of the boot
CD, those tricks are in a <para> marked as "only for zSeries build".
As noted on fedora-docs-list, there's currently a ToC in CVS that we
probably can and should work from. I will volunteer to edit parts, as
long as that doesn't stop me from writing other parts. I think we need
as many writers on this one as we can get away with, given the size of
the project (and how much we need it done). I don't have experience
beyond the ix86 arch, but certainly other arches could be dealt with
later as long as we have a strong document to begin with.
I'm getting on the CC list, and I will volunteer right now to handle
disk partitioning -- the setup, automatic, and manual. That's probably
enough to chew for a bit.
I would like to suggest several guidelines for screenshots and any
1. PNG format. Is that too obvious?
2. No wider than 500 pixels. If your graphic is larger than that, use
GIMP (Image -> Scale Image) or mogrify to scale the image to no wider
than 500 pixels.
3. Graphics should be included as <figure> I think.
Can someone else more knowledgeable in guide creation (*cough* Tammy
*cough* Karsten *cough*) add to this list?
(Added myself to the CC list)
Created attachment 104339 [details]
Draft Beginning Installation chapter for Fedora Installation Guide
Created attachment 104340 [details]
Draft Network Installation Servers Chapter for Fedora Installation Guide
This is not on the original ToC, but it seemed reasonable since PXE boot and
network install methods are part of the IG.
Created attachment 104341 [details]
Draft Upgrading Chapter for Fedora Installation Guide
Created attachment 104684 [details]
Draft "Installation Types" Chapter
Created attachment 104685 [details]
Draft "Network Configuration" Chapter for Installation Guide
Created attachment 104686 [details]
"Default Partition Scheme" Note for Installation Guide
Not a chapter, just a piece that someone can recycle if it's useful.
Created attachment 105247 [details]
Draft "Network Installation Servers" Chapter for Fedora Installation Guide
Updated for FC3t3.
Created attachment 105248 [details]
Draft "Firewall Configuration" Chapter for Fedora Installation Guide
Created attachment 105249 [details]
Draft "Language Support" Chapter for Fedora Installation Guide
Created attachment 105250 [details]
Draft "Timezone Configuration" Chapter for Fedora Installation Guide
Created attachment 105251 [details]
Draft "Root Password" Chapter for Fedora Installation Guide
I'm changing this bug to block the docs in progress bug since Stuart
has made great progress on this. Great work Stuart!
Created attachment 112904 [details]
Draft "Disk Partitioning" chapter for Fedora Installation Guide (finally!)
Created attachment 112956 [details]
New draft "DIsk Partitioning" chapter for FIG
This new Disk Partitioning chapter supersedes the old one. It now moves in a
more linear fashion. First it gives the reader advice on whether to choose
automatic or manual partitions. If the reader chooses manual, the chapter now
provides a small section about partition setup, to be read if necessary, before
making manual choices with Disk Druid. This chapter should flow more like a
Suggestion from IRC to include the approximate size of an Everything installation.
Which, uh, is in the release notes, but is still a nice thing:
<Evenios> fedora core 3 release notes (non 64-bit)
<Evenios> Custom Installation (Everything): 6.9GB
So, we can include it if it's not a hassle.
I'll put it in. 6.9 Gb is worth a comment :)
Committed Stuart's 0.6.2 release to docs CVS.
I think we need to add an admonition to the Language Selection section about
making sure that *every* needed language is added at install time because adding
it later is impossible. Below is a patch:
RCS file: /cvs/docs/install-guide/fedora-install-guide-packageselection-en.xml,v
retrieving revision 1.7
diff -u -p -r1.7 fedora-install-guide-packageselection-en.xml
--- fedora-install-guide-packageselection-en.xml 15 May 2005 16:02:49 -0000 1.7
+++ fedora-install-guide-packageselection-en.xml 16 May 2005 21:29:20 -0000
@@ -154,6 +153,14 @@
+ <title>Language Selection Is Permanent</title>
+ Be sure to include every language that may be needed for your system.
+ Adding additional languages after the installation is completed is
neither supported nor recommended.
Thanks - I've now added this.
To help us keep a handle on work, I've set up a tracker bug (#161575). I would
recommend this bug be CLOSED as CURRENTRELEASE since the IG has actually been
issued at this point. The following section is here for the information of new
users who may not be familiar with Bugzilla.
= = = = =
Any further RFE's or other suggestions should be entered as NEW bugs, and set to
block bug #161575 ("ig-traqr"). Visit the following URL to create a new bug:
After you commit your new bug, skip to the bottom of the report and find the
field labeled "Bug <NUMBER> blocks:" and enter either "ig-traqr" or the
Installation Guide tracker bug number (#161575) in that field.
This notice is probably unnecessary, since this bug will be closed, but just in
case someone is trolling for old bugs:
Because Fedora Documentation now has its own product and components, bug entries
for the Install Guide will be entered slightly differently. Ignore comment #23
above and use this TinyURL instead:
The "ig-traqr" bug is automatically blocked.