installation guide

[Paul W. Frields]

Cf. http://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=129911

I'll volunteer for partitioning, as mentioned in the &BZ; entry above. I
would like to suggest several guidelines for screenshots and any other
graphics (I think the GDSG may use something similar to these, IIRC):

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?

Here's another one I just thought of; the GDSG mentions this as well:

4. Graphics should not be included unless you absolutely *cannot* get
along without it. There's no reason to include repetitive screenshots of
parts of the interface that are easily explained in a sentence.
(Example: anaconda runs several progress bars when it computes package
dependencies, writes an install image to the drive, etc.... those don't
need to be screenshotted. Wait, is that a real word?)

-- 
Paul W. Frields, RHCE