TroubleshootingGuide
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 guide intended for new users will provide in depth information 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 within 5 minutes.
Design
The troubleshooting guide could be divided into sections, for different issues. For example, 'Installing Ubuntu', 'Graphical Problems', etc.
Implementation
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.