KarmicInstallationGuide

Differences between revisions 3 and 4
Revision 3 as of 2009-04-26 15:12:03
Size: 5213
Editor: 94-192-142-97
Comment: Added common problems section
Revision 4 as of 2009-04-27 11:07:31
Size: 5381
Editor: 87
Comment:
Deletions are marked like this. Additions are marked like this.
Line 43: Line 43:
 * The the beginning of the ''troubleshooting common problems'' chapter should have a list links to wiki pages for laptop specific issues (e.g. eeepc and macbook).
Line 54: Line 55:

Summary

There is a clear need for a comprehensive installation guide which targets novice and intermediate users. Such a guide should be written and made easily discoverable to potential new users.

Release Note

An Installation Guide is now available to help new users get Ubuntu onto their computer with the minimum of fuss.

Rationale

Despite the simplicity of our installer, the installation process is still fraught with uncertainties, technical concepts and potential errors which new users may struggle with. An official, comprehensive guide to installing Ubuntu does not currently exist, and the alternatives are not available in the most useful locations (i.e. on the Ubuntu CD or the download page).

Installation is a hot user assistance topic - 7 of the top 20 pages on the community wiki are related to installation. Failed installations are a common reason for users abandoning Ubuntu early-on in their experience. We should take this opportunity to provide some extremely useful, user-friendly documentation on the topic, which new users will be able to depend on for almost all of their installation enquiries.

Use Cases

  • Plato is thinking about installing Ubuntu, but isn't sure what the installation process would entail. Would it be a difficult technical job? Would he need to prepare for it at all? Where should he start? It's all Greek to him. A weighty treatise is required to put his mind at rest and show him the way forward.
  • Euripides' Ubuntu installation attempt failed when the bootloader threw an error after the computer restarted. Now his computer is unusable. How can he rescue himself from this tragic situation?
  • Euclid is a Windows power user, but has recently decided to try Ubuntu. He can work out how to use the installer just fine, but he's having problems with the specifics of dual boot setup. How much disk space does he need? Should he use an extended partition? A Google search offers lots of conflicting information. He needs some reliable advice to make it all add up.

Assumptions

  • Guide will fit onto the CD.

Design

  • Split into small number of "chapters", each one covering a major phase in the installation. Some users may only be interested in one chapter. It will also break-up the process, making it easier to follow.

  • Within each chapter, the instructions should be sequential and targeted at novice users. Images should be used to reinforce instructions in the text.

  • More advanced information, targeted at intermediate users, should be made available in info boxes.

  • Specific, accurate information should be available, such as system requirements and estimated disk usage.

  • A useful troubleshooting section should be available, covering common issues and providing practical solutions.

  • A summary document should be written to accompany the guide, to provide users with a quick reference on key installation points.

  • Advanced installation methods, such as installing from a network, should not be covered.

  • The writing should be comprehensive, but not verbose.
  • An index should possibly be compiled for users only interested in one specific issue.
  • The the beginning of the troubleshooting common problems chapter should have a list links to wiki pages for laptop specific issues (e.g. eeepc and macbook).

Proposed structure:

  1. Title page, contents, etc.
  2. What are the requirements for installing Ubuntu?
  3. Get a copy of the Ubuntu CD
  4. Try Ubuntu before installing it
    • Installing on Windows with Wubi
    • Booting from a live CD
  5. Install Ubuntu
  6. Troubleshooting common problems

Common problems for the Troubleshooting section

  • I can't boot off the Live CD
  • Uninstalling Ubuntu and reinstalling Windows

Implementation

The document should be written in Docbook and provided in HTML and PDF formats.

UI Changes

  • Both the Live CD and Windows installers should provide a prominent link to relevant sections of the guide.
  • The download page at ubuntu.com should prominently link to the guide.

Code Changes

Docbook XML will be written from scratch. Code changes may be required in the installers to provide a link to the guide.

Migration

The Switching from Windows documentation will be removed and, where relevant, replaced by a link to the new guide.

Test/Demo Plan

The guide should be exposed to users before string freeze, in order to identify any faults and to ensure its relevance. The Ubuntu Forums are probably the best arena for this.

Unresolved issues

This should highlight any issues that should be addressed in further specifications, and not problems with the specification itself; since any specification with problems cannot be approved.

BoF agenda and discussion

Use this section to take notes during the BoF; if you keep it in the approved spec, use it for summarising what was discussed and note any options that were rejected.


CategorySpec

Specs/KarmicInstallationGuide (last edited 2009-07-09 22:16:43 by 99-17-234-175)