Installation Guide

[Stuart Ellis]

On Wed, 08 Sep 2004 21:19:33 -0700, "Karsten Wade" <kwade(a)redhat.com&gt;
said:
>  Probably a good idea to assume that one person will do all the
>  screenshots in one pass.  These should be done with a later test version
>  of FC3 (test2 or test3).
>
>  To fill the space, perhaps a verbal description of the screen, noting
>  anything that is different from how it appears by default, i.e., what
>  you would want changed for a screenshot.
>
>  One nice idea about setting a standard is the person who does the
>  screenshots can grep all the XML for "FIXME" or "SCREENSHOT".
>
>  I'd suggest putting in blank <screenshot/> blocks along with a
>  <remark/>, but I'm not sure you can do that without breaking the build.
>  
I think that I'll probably use this format:

<para><remark role="FIXME">SCREENSHOT - (name of screen and
window),
(description of requirement)</remark></para>

<para><remark role="FIXME">LINK - (name of unwritten
section)</remark></para>

<para><remark role="FIXME">TECHQUERY - (description of technical
detail
that needs to checked) </remark></para>


>  > It would definitely be best if one person does all of the
> screenshots,
>  > especially since what I know about the Gimp at the moment probably
>  > wouldn't fill the 500x375 rectangle, but I'm not sure if we have a
>  > screenshotter to do the work.
>
>  Not yet, but we will.  That job will need to be done either at the end
>  of Sep. or the first week of October. 
OK.  I'll press on with the text.
--
Stuart Ellis
s.ellis(a)fastmail.co.uk

[Karsten Wade]

On Thu, 2004-09-09 at 05:48, Stuart Ellis wrote:

>  I think that I'll probably use this format:
>  
>  <para><remark role="FIXME">SCREENSHOT - (name of screen and
> window),
>  (description of requirement)</remark></para>
>  
>  <para><remark role="FIXME">LINK - (name of unwritten
>  section)</remark></para>
>  
>  <para><remark role="FIXME">TECHQUERY - (description of technical
> detail
>  that needs to checked) </remark></para> 
                        ^
+1 

I like these, they seem good and sufficient for now.

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

[Mark Johnson]

Karsten Wade wrote:
>  On Thu, 2004-09-09 at 05:48, Stuart Ellis wrote:
>  
>  
> >I think that I'll probably use this format:
> >
> ><para><remark role="FIXME">SCREENSHOT - (name of screen and
> window),
> >(description of requirement)</remark></para>
> >
> ><para><remark role="FIXME">LINK - (name of unwritten
> >section)</remark></para>
> >
> ><para><remark role="FIXME">TECHQUERY - (description of technical
> detail
> >that needs to checked) </remark></para>
>  
>                          ^
>  +1 
>  
>  I like these, they seem good and sufficient for now. 
Karsten's statement seems sufficient to me. For now, anyway:)

Mark


>  
>  - Karsten 

-- 
----------------------------------------------------------
Mark Johnson                     <mjohnson(a)redhat.com&gt;
OS Product Documentation
Engineering, Red Hat, Inc.       <http://www.redhat.com>
Tel: [phone]                Fax: [phone]
GPG fp: DBEA FA3C C46A 70B5 F120  568B 89D5 4F61 C07D E242