UbuntuHelp

Differences between revisions 1 and 6 (spanning 5 versions)
Revision 1 as of 2005-05-28 20:11:33
Size: 2864
Editor: adsl-213-190-44-43
Comment: imported from the old wiki
Revision 6 as of 2005-07-23 00:10:18
Size: 4345
Editor: 200-171-140-32
Comment: move and clarify license
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= LocalHelp = = Ubuntu Help =
Line 3: Line 3:
This is a suggested outline of the help available when someone chooses "Help" from Ubuntu's top-level menus. This help should be aimed at people who already have Ubuntu installed, but who don't have the time, knowledge, or courage to use forums or read manuals. They may be complete beginners, businesspeople on a deadline, or harried sysadmins. When they look for help, they may not even have an Internet connection. This system will integrate help for the main software components on the Ubuntu CD, whether they come from gnome.org, openoffice.org, or anywhere else, because Aunt Tillie doesn't care about those distinctions. This is the help that should appear when someone chooses "Help" from Ubuntu's top-level menus. The help should be aimed at people who already have Ubuntu installed, and need answers fast. They may be complete beginners, businesspeople on a deadline, or harried sysadmins. They may not even have a working Internet connection. The system should integrate help from gnome.org, ubuntu.com, openoffice.org, and anywhere else, because Aunt Tillie doesn't care about those distinctions.

== License for the help ==

So that extracts from the help can be embedded into future software for greater effectiveness (requiring the GPL), and so that the help can be used by Debian (ruling out the GFDL), it is intended that the help will be governed by this license:

 This document is Copyright 2004 its contributors as defined in the section titled AUTHORS. This document is released under the terms of the GNU General Public License, version 2 or later <`http://www.gnu.org/licenses/gpl.html`>, or under the terms of the Creative Commons Attribution License, version 2.0 or later <`http://creativecommons.org/licenses/by/2.0/`>, at the option of any party receiving it.
Line 7: Line 13:
Each page should contain no more than about a dozen subtopics. Local help is faster than the Web, so you can get away with having less on each page, and thereby avoid scrolling. Design for compact layout, so the help viewer can go alongside the software you're wanting help on. Brevity, brevity, brevity. People [http://helpware.net/longhorn/review1b.htm#TOC_Index_Search don't read help tables of contents] if they can search instead. So when search is implemented in the help viewer, the main table of contents should be simplified to four or five things that people can glance at while entering their search terms. Until then, it should contain no more than about a dozen subtopics. Local help is faster than the Web, so you can get away with having less on each page, and thereby avoid scrolling. Design for compact layout, so the help viewer can go alongside the software you're wanting help on. Brevity, brevity, brevity.
Line 16: Line 22:
 * Disks and storage devices  * Disks and devices
Line 49: Line 55:
 * Connecting to another Ubuntu computer
 * Connecting to a Windows computer
Line 50: Line 58:
 * Sharing files  * Sharing files with a Macintosh
Line 52: Line 60:
## The exact collection of topics here depends on how much they have in common with each other.

=== Disks and storage devices ===
 
 * Using floppy disks
 * Connecting extra hard disks
 * Burning files to CD

''See also'' Music, photos, and video
Line 56: Line 73:
 * How do I play MP3 files?
 * Copying music from CD to computer
 * Copying music from computer to CD
 * Playing MP3 music files?
 * Playing Windows Media music files
 * Connecting an iPod or other music player

 * Copying music from CD to the computer
 * Copying music from the computer to CD
Line 62: Line 81:
=== Printing === === Printing and scanning ===
Line 67: Line 86:
 * How to set up a scanner
 * If scanning doesn't work
Line 70: Line 91:
## These subsections are deliberately in the imperative tense.
Line 72: Line 94:
 * Set your screen to lock when you're away
Line 73: Line 96:
 * ...
Line 80: Line 102:
 * A computer has a blank screen
 * A computer is frozen or running very slowly
 * An Ubuntu computer has a blank screen
 * An Ubuntu computer is frozen or running very slowly

Ubuntu Help

This is the help that should appear when someone chooses "Help" from Ubuntu's top-level menus. The help should be aimed at people who already have Ubuntu installed, and need answers fast. They may be complete beginners, businesspeople on a deadline, or harried sysadmins. They may not even have a working Internet connection. The system should integrate help from gnome.org, ubuntu.com, openoffice.org, and anywhere else, because Aunt Tillie doesn't care about those distinctions.

License for the help

So that extracts from the help can be embedded into future software for greater effectiveness (requiring the GPL), and so that the help can be used by Debian (ruling out the GFDL), it is intended that the help will be governed by this license:

  • This document is Copyright 2004 its contributors as defined in the section titled AUTHORS. This document is released under the terms of the GNU General Public License, version 2 or later <http://www.gnu.org/licenses/gpl.html>, or under the terms of the Creative Commons Attribution License, version 2.0 or later <http://creativecommons.org/licenses/by/2.0/>, at the option of any party receiving it.

Style guide

People [http://helpware.net/longhorn/review1b.htm#TOC_Index_Search don't read help tables of contents] if they can search instead. So when search is implemented in the help viewer, the main table of contents should be simplified to four or five things that people can glance at while entering their search terms. Until then, it should contain no more than about a dozen subtopics. Local help is faster than the Web, so you can get away with having less on each page, and thereby avoid scrolling. Design for compact layout, so the help viewer can go alongside the software you're wanting help on. Brevity, brevity, brevity.

Ubuntu Help

  • If you're new to Ubuntu 5.10
  • Customizing settings
  • Internet and networking
  • Working with files from Windows
  • Documents, files, and folders
  • Disks and devices
  • Music, photos, and video
  • Printing and faxing
  • Keeping your computer safe
  • Maintenance and troubleshooting
  • Advanced topics
  • Getting more help

If you're new to Ubuntu 5.10

  • What is Ubuntu?
  • If you've been using Ubuntu 5.04
  • If you've been using Ubuntu 4.10
  • If you've been using Microsoft Windows
  • If you've been using Mac OS X

Customizing settings

  • Changing the background picture
  • Choosing a screensaver
  • Saving power
  • Accessibility options
  • Keyboard layout
  • Setting the date and time
  • ...

Internet and networking

  • Connecting to the Internet
  • Finding things on the Web
  • Sending and receiving e-mail
  • Chatting online
  • Connecting to another Ubuntu computer
  • Connecting to a Windows computer
  • Connecting to a Windows network
  • Sharing files with a Macintosh
  • ...

Disks and storage devices

  • Using floppy disks
  • Connecting extra hard disks
  • Burning files to CD

See also Music, photos, and video

Music, photos, and video

  • Listening to music
  • Playing MP3 music files?
  • Playing Windows Media music files
  • Connecting an iPod or other music player
  • Copying music from CD to the computer
  • Copying music from the computer to CD
  • Playing videos
  • ...

Printing and scanning

  • How to set up a printer
  • If printing doesn't work
  • If printing works, but not the way you want
  • How to set up a scanner
  • If scanning doesn't work

Keeping your computer safe

  • Use separate accounts for each person
  • Keep your software up to date
  • Set your screen to lock when you're away
  • Set up a firewall

Maintenance and troubleshooting

  • Sound doesn't work
  • Programs keep disappearing or crashing
  • My desktop icons have disappeared
  • An Ubuntu computer has a blank screen
  • An Ubuntu computer is frozen or running very slowly

Advanced topics

  • Using the terminal
  • Terminal commands reference ("man pages")
  • Setting up a file server
  • Setting up a print server
  • Writing your own programs
  • ...

UbuntuHelp (last edited 2008-08-06 16:29:32 by localhost)