TopLevelCategories

Differences between revisions 5 and 12 (spanning 7 versions)
Revision 5 as of 2006-11-29 08:01:02
Size: 1038
Editor: 85-210-195-200
Comment: forgot about-ubuntu
Revision 12 as of 2006-12-06 08:49:54
Size: 2748
Editor: 121-72-128-96
Comment: simplification suggestions
Deletions are marked like this. Additions are marked like this.
Line 6: Line 6:
  * New to Ubuntu - common questions (from https://help.ubuntu.com/CommonQuestions)
Line 8: Line 7:
  * Adding, Removing and Updating Applications (ditto)   * Moving to Ubuntu (the Switching from Windows/OS X/$distro document, if such exists)
  * Adding, Removing and Updating Applications (from the desktop guide)
Line 24: Line 24:
Just trying to figure out exactly how this would look which I currently can't in my head especially vs current svn layout. Would each section be a separate document in svn or would it just utilize a different flag, such as <article> instead of <book> to separate this?
Line 25: Line 26:
 * ''Go here''  * MatthewPaulThomas: At the top level any categorization is competing with a very tempting search field, so we need to work hard on simplification. I suggest:
  * Don't try to link to every help document from here. This is about the system in general, including the file manager (which most people won't recognize as an individual application) and preferences+administration tools (ditto). Help on things like "Games" and "Office" can be accessed from the Help menus of the relevant programs.
  * "Introduction to Ubuntu", "Linux Basics", and "Moving to Ubuntu" can be collected under a "New to Ubuntu 7.04?" category.
  * "Using your desktop" is not something people will choose to click on (unless they're clicking on ''everything''). There is no good way to handle the Gnome User Guide pre-Mallard, but perhaps the least bad option is to place it under the goal-based categories (separated by a line).
  * "Music and Video" and "Graphics and Pictures" could be merged into "Music, photos, and video". ("How do I get photos off my digital camera?" is a common goal for which you're likely not to know the appropriate application. "How do I draw a picture?" is much less common, and if you want to do that you're likely to find the appropriate applications and their Help menus.)
 * "Programming", "Setting up a `______` server", and maybe even "Contributing to Ubuntu" could be collected under an "Advanced topics" category.

Top Level Categories

This page is to work on the menu structure for the TopicBasedHelp specification.

  • Introduction to Ubuntu (the About Ubuntu document)
  • Linux Basics (from the desktop guide, should include information about administrative tasks)
  • Moving to Ubuntu (the Switching from Windows/OS X/$distro document, if such exists)
  • Adding, Removing and Updating Applications (from the desktop guide)
  • Using your Desktop (from the Gnome user guide)
  • Desktop Customisation (ditto)
  • Music and Video (from the desktop guide)
  • Internet (ditto)
  • Office (ditto)
  • Graphics and Pictures (ditto)
  • Games (ditto)
  • Programming (ditto)
  • Running Server Applications (from the server guide)
  • Getting More Help (from the Getting More Help document)
  • Contributing to Ubuntu (from the Contribute document)

Naturally each section would be customised to suit the TopicBasedHelp specification, and incorporate reliable material from other sources, such as the wiki.

Comments/Ideas

Just trying to figure out exactly how this would look which I currently can't in my head especially vs current svn layout. Would each section be a separate document in svn or would it just utilize a different flag, such as <article> instead of <book> to separate this?

  • MatthewPaulThomas: At the top level any categorization is competing with a very tempting search field, so we need to work hard on simplification. I suggest:

    • Don't try to link to every help document from here. This is about the system in general, including the file manager (which most people won't recognize as an individual application) and preferences+administration tools (ditto). Help on things like "Games" and "Office" can be accessed from the Help menus of the relevant programs.
    • "Introduction to Ubuntu", "Linux Basics", and "Moving to Ubuntu" can be collected under a "New to Ubuntu 7.04?" category.
    • "Using your desktop" is not something people will choose to click on (unless they're clicking on everything). There is no good way to handle the Gnome User Guide pre-Mallard, but perhaps the least bad option is to place it under the goal-based categories (separated by a line).

    • "Music and Video" and "Graphics and Pictures" could be merged into "Music, photos, and video". ("How do I get photos off my digital camera?" is a common goal for which you're likely not to know the appropriate application. "How do I draw a picture?" is much less common, and if you want to do that you're likely to find the appropriate applications and their Help menus.)
  • "Programming", "Setting up a ______ server", and maybe even "Contributing to Ubuntu" could be collected under an "Advanced topics" category.

TopicBasedHelp/TopLevelCategories (last edited 2008-08-06 16:29:17 by localhost)