Ubuntu Wiki

• Launchpad Entry: https://launchpad.net/ubuntu-doc/+spec/troubleshooting-guide

• Created: June 07, 2008 by NickEllery

• Contributors: NickEllery

• Packages affected: [https://launchpad.net/ubuntu-doc]

Summary

A troubleshooting section for each category of the documentation intended for new users will provide quick solutions on common questions.

Rationale

Every single new user to Ubuntu will encounter a problem, in some way or another. A troubleshooting guide containing a large amount of 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. For example, 'Installing Ubuntu', 'Graphical Problems', etc.

Implementation

The troubleshooting docs will be implemented into each category of the documentation. For example, the Customizing your Desktop category will have a troubleshooting section at the end of it.

Please submit any ideas to the [https://wiki.ubuntu.com/TroubleshootingGuide/IdeaPool Idea Pool].

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.

CategoryDocteam