TroubleshootingGuide

Differences between revisions 6 and 7
Revision 6 as of 2008-06-10 03:18:53
Size: 2112
Editor: 209
Comment:
Revision 7 as of 2008-06-12 02:25:33
Size: 2322
Editor: 209
Comment:
Deletions are marked like this. Additions are marked like this.
Line 32: Line 32:
== Implementation ==

A list of some common questions that have been asked in the forums can be found [http://philbull.googlepages.com/CommonQuestions-UbuntuForums.pdf here].
Line 34: Line 38:
There are an extremely large amount of issues that a user that could encounter. It is best to keep the guide at a readable length, so choosing the most common issues will be a necessity.  There are an extremely large amount of issues that a user that could encounter. It is best to keep the guide at a readable length, so choosing the most common issues will be a necessity.

== Comments ==
Line 37: Line 43:
CategoryDocteam CategoryDocteam CategorySpec

Summary

A troubleshooting section for each category of the documentation intended for new users will provide quick solutions on common questions. This will help to lower the amount of simple questions on the forums and other support sources. The goal is to have this completed at the end of the IntrepidIbex release cycle.

Rationale

Every single new user to Ubuntu will encounter a problem, in some way or another. Troubleshooting docs containing the most common issues would greatly assist new users.

Use cases

Steven heard about an operating system called Ubuntu, and decided to give it a try. Upon installing Ubuntu, he decided to install some applications via Synaptic. After installing several programs, he closed Synaptic. He then remembered there was another application he wanted to install, so he re-opened Synaptic. He then discovered that he could not run Synaptic because he had a dpkg --configure -a error. His first instinct was to look through the documentation to find information on the topic, but could not. He then went to the forums, where he asked about this issue, and had a reply and solution within 5 minutes.

Design

The troubleshooting guide could be divided into sections, for different issues. Each of these categories will be synced and placed in each of the Official Documentation pages.

Those will be:

  • Adding and Removing Software
  • Files, Folders, and Documents
  • Desktop Customization/Graphical Problems
  • Internet/Connectivity
  • Music, Video, and Photos
  • Printing and Faxing

Implementation

A list of some common questions that have been asked in the forums can be found [http://philbull.googlepages.com/CommonQuestions-UbuntuForums.pdf here].

Outstanding issues

There are an extremely large amount of issues that a user that could encounter. It is best to keep the guide at a readable length, so choosing the most common issues will be a necessity.

Comments


CategoryDocteam CategorySpec

TroubleshootingGuide (last edited 2008-08-06 16:14:49 by localhost)