Re: Can I work in the Wiki for GNOME User Guide or I for got it?

[Daniel Espinosa <esodan gmail com>]

Then What about to have a Top Level colled: "GNOME User Guide", then split it in the following items:

"Using your Desktop"
Try to have covered all the basic skills about the system, for the general or ocasional user.

"Configuring Your Desktop"
Describing the principal utilities in GNOME to customize your system.

"Desktop Utilities"
Put here the utilities avairable in the desktop that can be usefull but
not directly relation with the others parts of the Guide.

This is to follow a down-top topics (the most common and easy to more advanced).

For example, if a general user need to know how to login to session and
how to logout, it must be in any part of the Using your Desktop, at the
top level part, may in the "Basic Skills".

I think this is as writing a letter to the most important peaple in an
enterprice, he need to know the topic in the first "two rows", and "if
want to know more about" goes to the next rows and paragrahs of the
document.

2006/1/20, Joachim Noreiko <jnoreiko yahoo com>:

--- Daniel Espinosa <esodan gmail com> wrote:

> I'm trying change the contents and order in the
> Gnome User Guide, and
> becouse I don't have enough time, for the moment, to
> study the XML DocBook
> and how to create or edit documentation, I star to
> work in the Wiki at
> live.gnome.org, but anyone answer my question about
> if the changes are ok or
> not.

I'm taking a look at what you've done to the contents
page now.

I think it does make sense to split the whole user
guide into broad sections 'Using your Desktop' and
'Configuring Your Desktop'. But the problem is that
it's not very useful to have only three top-level
sections. This is because when Yelp opens the user
guide, you only see the top-level sections in the
left-hand bar and on the contents page. So the user
wishing to get started with GNOME has to make an extra
click to see a list of topics.
So I would suggest removing those three top-level
divisions.

Beneath that, I think what you've done with breaking
up 'Desktop Overview' is a good idea. It's a title
that doesn't convey much (especially since the whole
guide is a "desktop guide" and hence... an overview!
'Basics' is a bit nebulous too.

A section on Applications is a good idea I think.

I would quite like to move sections on Workspaces and
on Sessions further down. I think both of these
concepts are quite advanced. However, the reader needs
to be able to EASILY find out how to turn off their
computer! -- and that is currently in 'Sessions'.

That's all my thoughts on it so far :)

Joachim




___________________________________________________________
To help you stay safe and secure online, we've developed the all new Yahoo! Security Centre. http://uk.security.yahoo.com

-- 
Trabajar, la mejor arma para tu superación
"de grano en grano, se hace la arena" (R) (entrámite, pero para los cuates: LIBRE)