Organization of gnome-user-docs, display in yelp

[Aaron Weber <aaron ximian com>]

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.