Re: Updated Nautilus Section

[Joachim Noreiko <jnoreiko yahoo com>]

--- John Stowers <john stowers lists gmail com> wrote:

> Hey Everyone,
> 
> I have attached my first pass at the updated
> nautilus documentation. Please
> comment on what you think of this.

Looks very good!
If Shaun or Brent can look at this too and give their
approval, I'm happy to commit this.

Few small points:
I've found a couple of typos (which I've fixed in my
copy)
You've duplicated secion ids: basically when you
create a new section (<section> or <sect*>), give it a
unique ID, eg. "nautilus-searching". That's something
I can fix.
I'm not sure about your change of 'File Manager
Scripts' to 'Extending Nautilus', since that section
is currently all about Nautilus Scripts. You're
thinking of writing more in there about nautilus
extensions, so I'd suggest the whole of the scripts
section be demoted, like this:
- Extending Nautilus
-- Nautilus Scripts
-- Nautilus Extensions

You've added quite a few screenshots. Screenshots are
great (and you've done a really nice job with them!),
but they add to the burden of translation and
maintainance. Take the shot of just the 'Home' folder:
each translation has to redo the screenshot, and if
GNOME default icons are updated, we have to redo it
all over again. Much as it pains me after the work
you've put into these, we have to consider each
screenshot and decide if it's really necessary: how
much does its presence add to the documentation, and
is it something the user can see in front of them
anyway?
I really like the two shots that show the comparison
between browser mode and spatial though!

I think either after this batch of changes is
committed, or after your next lot of work, we need to
think about the order of the main sections in the
Nautilus docs.
Eg, I don't think 'Customizing the File Manager' or
'Assigning Actions to Files' should come before
'Opening Files', and in fact 'Assigning Actions to
Files' should perhaps be folded into 'Opening Files'.


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