A New Look at How We Write Content for the Desktop User Guide

[Karsten 'quaid' Wade]

On Mon, 2008-10-06 at 04:59 +0530, Mani A wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
> 
> Elizabeth Ann West  wrote:
> 
> 
> > operating system. These suggestions below are only for the Desktop Users
> > Guide, the specialized guide for new users of Fedora, presumably coming
> > from Windows, without Linux experience.
> 
> Some of the users may be having no prior experience with computers.
> Manuals for such people should include screen shots ...  and that is
> an optimization problem!

Agreed that there is a need for computer education for people without
experience using computers, but are we sure that Fedora wants to work on
that problem?

I think I'd rather see some common, upstream documentation that handles
that, such as from GNOME and KDE.  Then we can build from that as a
base.

> 1. New user does not learn about the name of the Add/Remove Software
> program. The first occurrence of "Add/Remove Software program" can be
> replaced by "Add/Remove Software program (called 'Pirut')".

How do they not learn about it?  Sorry, I'm not getting the initial
point.

In Fedora 9 and beyond, it is now PackageKit, and the main way to get it
is through the same '''Add/Remove Software''' launcher.  Because that is
setup to be a sort of alias or abstraction layer, I wonder if we want to
bother naming the application that currently runs underneath it?

For handling software updates in the Fedora 9 version of the User Guide,
it sounds like a good idea to keep Pirut/Pup documentation.  Note they
are a useful alternative that may have more features than came in the
initial PackageKit implementation.

> 2. 'kicker' is the whole of the main panel. "Fedora icon in the lower
> left corner called the Kicker" is just wrong.

I've never heard of any of that before.  Is there a canonical reference?

cheers - Karsten
-- 
Karsten Wade, Community Gardener
Dev Fu : http://developer.redhatmagazine.com
Fedora : http://quaid.fedorapeople.org
gpg key : AD0E0C41
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <http://listman.redhat.com/archives/fedora-docs-list/attachments/20081007/89937088/attachment.sig>