Images on installation guide

[Davidson Paulo]

Hi all,

My name is Davidson Paulo, I'm a brazilian Fedora Ambassador,
cvsdocs-admin, trying to work in Fedoca Docs since now. :-)

I was looking at the Fedora Installation Guide[1] and I saw there is
no images on the entire document. This is a standard? We in Brazil are
thinking to create a full-detailed Fedora installation guide that can
be enough to a new user install Fedora itself even without any
experience with installing Linux or any other operating system, but we
not want to create another unofficial guide, but improve what we
already have in hands.

So, what about including images in the official Fedora Installation Guide?

Thanks,

  * [1] http://docs.fedoraproject.org/install-guide/f7/en_US/

Davidson Paulo

[Mike Dittmeier]

On Tue, 2007-10-23 at 14:43 -0200, Davidson Rodrigues Paulo wrote:

>  Hi all,
>  
>  My name is Davidson Paulo, I'm a brazilian Fedora Ambassador,
>  cvsdocs-admin, trying to work in Fedoca Docs since now. :-)
>  
>  I was looking at the Fedora Installation Guide[1] and I saw there is
>  no images on the entire document. This is a standard? We in Brazil are
>  thinking to create a full-detailed Fedora installation guide that can
>  be enough to a new user install Fedora itself even without any
>  experience with installing Linux or any other operating system, but we
>  not want to create another unofficial guide, but improve what we
>  already have in hands.
>  
>  So, what about including images in the official Fedora Installation Guide?
>  
>  Thanks,
>  
>    * [1] http://docs.fedoraproject.org/install-guide/f7/en_US/
>  
>  Davidson Paulo
>   
easy enough to do. I have included images in several of my own docs, and
the documentation guide covers the use of images and figures.

If you have access to vmware workstation (demo even) it allows for nice
screen shoots of the install process. You can even create videos...


Mike "Ditt" Dittmeier
mike(a)vegasitpros.com

pub   1024D/3F08ECFB 2007-09-11 [expires: 2008-09-10]
      Key fingerprint = 8396 9850 E308 4EFF 1A22  6C5A 4FF5 DF6C 3F08
ECFB
uid                  Mike Dittmeier (Just "Ditt" to my friends)
<mike(a)vegasitpros.com&gt;
sub   2048g/1E6E4DBD 2007-09-11 [expires: 2008-09-10]

[Karsten Wade]

On Tue, 2007-10-23 at 14:43 -0200, Davidson Rodrigues Paulo wrote:
>  Hi all,
>  
>  My name is Davidson Paulo, I'm a brazilian Fedora Ambassador,
>  cvsdocs-admin, trying to work in Fedoca Docs since now. :-)
>  
>  I was looking at the Fedora Installation Guide[1] and I saw there is
>  no images on the entire document. This is a standard? We in Brazil are
>  thinking to create a full-detailed Fedora installation guide that can
>  be enough to a new user install Fedora itself even without any
>  experience with installing Linux or any other operating system, but we
>  not want to create another unofficial guide, but improve what we
>  already have in hands.
>  
>  So, what about including images in the official Fedora Installation Guide? 
Images are hard to maintain, hard to translate, have to be changed
constantly (with every test, potentially), and don't give any more
information than we already do with words.  The user is most often
following along with the instructions, so the screen is up in front of
them already.

I finally put this down somewhere:

http://fedoraproject.org/wiki/DocsProject/StyleGuide/FedoraSpecific#Scree...

If you are looking for something graphical to help new users who have
never done an OS install before, you might want to create a screencast.
To capture the screencast, it probably has to be installed in a virtual
environment.

- Karsten
-- 
Karsten Wade, Developer Community Mgr.
Dev Fu : http://developer.redhatmagazine.com
Fedora : http://quaid.fedorapeople.org
gpg key : AD0E0C41

[Karsten Wade]

On Tue, 2007-10-23 at 12:48 -0400, Mike Dittmeier wrote:

>  easy enough to do. I have included images in several of my own docs,
>  and the documentation guide covers the use of images and figures. 
Yeah, understood, but please see my other reply; there are many good
reasons to not have screenshots and no good reason to have them. :)

>  If you have access to vmware workstation (demo even) it allows for
>  nice screen shoots of the install process. You can even create
>  videos... 
Or, if you have Fedora :), you can use one of the virtualization options
(Xen, KVM, Qemu).

We *really* would benefit from screencasts, even though they are harder
to maintain and localize.  Good for install, also good for helping new
people to contribute, etc.

- Karsten
-- 
Karsten Wade, Developer Community Mgr.
Dev Fu : http://developer.redhatmagazine.com
Fedora : http://quaid.fedorapeople.org
gpg key : AD0E0C41