Re: Organization of gnome-user-docs, display in yelp

[Alexander Kirillov <kirillov math sunysb edu>]

Dear Aaron:
as for merging "intro to gnome" with the user guide - you are right that
the  introductory part of User Guide and "Intro to gnome" serve roughly
the same purpose. On the other hand, they are quite different in style.
I personllay think that it may be worthwhile to keep both, but if other
people think that it creates confusion, we could just scrap "intro to
gnome"

As for all these sections ("Basic skills", "Desktop background", etc) -
these are just the chapters of UG. I agree that it may be better to lump
all preference tools under  one heading (in fact, they are lumped
together - as a part of UG). But it is less clear what to do with the
others: "working with panels" is a separate chapter of UG, not under
"Overview of desktop". And "basic skills" - if you read it - doesn't
really belong to "Overview of the desktop".  

Maybe we can do it this way: include in the top level menu "User Guide",
"Preference tools", "Sysyadmin guide" and "accessibility guide", and
that's it? So those who want to get overview of the desktop or docs for
Nautilus will open the UG and find it there... 
 
Eugene?


On Thu, 2003-02-13 at 15:27, Aaron Weber wrote:
> Hello all,
> 
> I've been looking at gnome-user-docs a little recently, and it's kind
> of got me confused, partly because I've had a hard time mapping files
> to the documents as displayed in Yelp.
> 
> It appears that we've got two general introductions-- both the
> gnome2-users-guide and the introduction-to-gnome. Do we need both of
> these? Could they be merged?
> 
> When I click "Desktop" I get the following documents list, which I
> assume is generated from OMF files:
> 
> Solaris Accessibility Guide
> System Administration Guide
> Introduction to GNOME
> Accessibility Preferences
> Basic Skills
> Advanced Preferences
> Basic Preferences
> Menus
> Desktop
> Background 
> Sessions
> Windows 
> Nautilus File Manager 
> Overview 
> Panels 
> Search for Files 
> 
> I'm not even running Solaris!  Why is the "basic skills" section in
> the middle of the list? Should some of those items be listed under
> others?  "Desktop Background" really sounds like it's about how to set
> your wallpaper, even though I know it's about how to use the desktop
> background-- could we call it "The Nautilus File Manager and the
> Desktop?" maybe. or "Files on the Desktop"?
> 
> Personally, I'd merge "Overview" and "introduction", put "basic
> skills" under that, then put all the preferences items under one
> heading, including the accessibility stuff.... but maybe not hide it:
> 
> Overview
>   * Basic skills
>   * Windows
>   * The Nautilus file manager
>   * Panels
>   * Menus
>   * Search for files
> 
> Preferences:
>    * Basic Preferences
>    * Advanced Preferences
>    * Accessibility Preferences
> 
> and so forth.
> 
> That might be beyond what OMF will do, though. I dunno. 
> 
> What do you all think about the way that module is organized? Is there
> a better way to do it?
> 
> a.