EvaluateUbuntuGuide
|
Size: 851
Comment:
|
Size: 3887
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 3: | Line 3: |
| * Created: [[Date(2005-10-06T20:59:08Z)]] by JaneWeideman * Priority: NeedsPriority * People: NeedsLead, NeedsSecond * Contributors: JaneWeideman * Interested: * Status: UbzSpecification, BrainDump (then DraftSpecification then EditedSpecification then ApprovedSpecification), DistroSpecification * Branch: UbuntuTrack * Malone bug: * Packages affected: * Depends: * Dependents: [[FullSearch()]] * BoF sessions: none yet |
* '''Launchpad entry:''' https://launchpad.net/distros/ubuntu/+spec/evaluate-ubuntu-guide * Created: <<Date(2005-10-06T20:59:08Z)>> by JaneWeideman * Contributors: JaneWeideman, MatthewPaulThomas, CoreyBurger, SivanGreen * Packages: `ubuntu-doc` |
| Line 18: | Line 9: |
| Evaluate Ubuntu Guide, the forum howto's and the wiki pages to see what can be made easier/better/improved, see UbuntuGuide | Ubuntu Guide (ubuntuguide.org) is a valuable source of help for different versions of Ubuntu, and much of its information is more current than the official Ubuntu documentation. In the past it was somewhat concentrated on non-graphical solutions, but the Guide undergoes constant revision. The possibility of incorporating the information found at the site into `help.ubuntu.com` will be investigated. In addition, specialized help pages will be produced for some topics, and several feature goals will be registered for future Ubuntu development. |
| Line 22: | Line 14: |
| * The Ubuntu Guide was not originally updated, but currently is updated more frequently than the official Ubuntu documentation. * The Guide concentrates on both GUI solutions as well command-line soultions. * The Guide provides a wealth of links that are not found in official Ubuntu documentation, or for legal reasons are not desirable to be included in official Ubuntu documentation. |
|
| Line 24: | Line 22: |
| == Scope == | * Jonathan switches from Kubuntu to Ubuntu. A couple of months later, his ISP switches to using DHCP, and Jonathan wants to know how to configure this in Ubuntu. So he searches the Web for "ubuntu dhcp". |
| Line 26: | Line 24: |
| == Design == | * Marian switches from Gentoo to Ubuntu, and is confused by the lack of a "root user". She Googles for "root account in ubuntu". * Eun Park wants to know how to enter Korean text in Ubuntu. She searches at Yahoo Korea for "ubuntu 한국어". |
| Line 30: | Line 30: |
| === Code === | Once [[http://help.ubuntu.com/|help.ubuntu.com]] is working, the possibility of incorporating information from `ubuntuguide.org` will be investigated. |
| Line 32: | Line 32: |
| === Data preservation and migration === | In addition, extra documents and specs will be created covering specific topics for which the Ubuntu Guide is currently necessary. (''See also'' DesktopGuide ''and'' ServerGuide.) The following subsections are the same as the sections in the Ubuntu Guide, showing how the need for each can be minimized. |
| Line 34: | Line 34: |
| == Outstanding issues == | Design elements of UbuntuGuide that are desirable, such as brevity, outlining, and ease of navigation will be used to improve official Ubuntu documentation. |
| Line 36: | Line 36: |
| == BoF agenda and discussion == | == Discussion == * I feel that this is something Ubuntu strives to be best at, the more work that is done to improve the ease of which new users can switch to Ubuntu the better in my opinion. It would be really good if the people who work on the above suggestions try to keep the DocumentationTeam in the loop as much as possible. Often late in development things like the above can change making parts of our documentation redundant/incorrect, which was defiantly an issue during Breezy development. The only other thing I would like to add is that not only should the above be evaluated, but people such as regular forum users, people who help out on IRC often and docteam people like myself are also good sources of knowledge on what things could be made easier, so pick our brains too! - RobertStoffers * Part of this spec is unimplementable: we shouldn't and can't force people who write private resources to stop hosting them and/or redirect their webpages to official sites. We've tried to talk the question over with the maintainers of the guide at [[http://ubuntuforums.org/showthread.php?t=81320|this forum thread]]. ([[mdke]]) * Further, the statement that blunt non-graphical solutions are not useful ignores the userbase: almost every user I've had feedback from about the current official docs has stated that they preferred CLI based solutions. We need to reconcile this with a desire to focus on graphical solutions for those who like them. ([[mdke]]) |
Launchpad entry: https://launchpad.net/distros/ubuntu/+spec/evaluate-ubuntu-guide
Created: 2005-10-06 by JaneWeideman
Contributors: JaneWeideman, MatthewPaulThomas, CoreyBurger, SivanGreen
Packages: ubuntu-doc
Summary
Ubuntu Guide (ubuntuguide.org) is a valuable source of help for different versions of Ubuntu, and much of its information is more current than the official Ubuntu documentation. In the past it was somewhat concentrated on non-graphical solutions, but the Guide undergoes constant revision. The possibility of incorporating the information found at the site into help.ubuntu.com will be investigated. In addition, specialized help pages will be produced for some topics, and several feature goals will be registered for future Ubuntu development.
Rationale
- The Ubuntu Guide was not originally updated, but currently is updated more frequently than the official Ubuntu documentation.
- The Guide concentrates on both GUI solutions as well command-line soultions.
- The Guide provides a wealth of links that are not found in official Ubuntu documentation, or for legal reasons are not desirable to be included in official Ubuntu documentation.
Use cases
- Jonathan switches from Kubuntu to Ubuntu. A couple of months later, his ISP switches to using DHCP, and Jonathan wants to know how to configure this in Ubuntu. So he searches the Web for "ubuntu dhcp".
- Marian switches from Gentoo to Ubuntu, and is confused by the lack of a "root user". She Googles for "root account in ubuntu".
- Eun Park wants to know how to enter Korean text in Ubuntu. She searches at Yahoo Korea for "ubuntu 한국어".
Implementation
Once help.ubuntu.com is working, the possibility of incorporating information from ubuntuguide.org will be investigated.
In addition, extra documents and specs will be created covering specific topics for which the Ubuntu Guide is currently necessary. (See also DesktopGuide and ServerGuide.) The following subsections are the same as the sections in the Ubuntu Guide, showing how the need for each can be minimized.
Design elements of UbuntuGuide that are desirable, such as brevity, outlining, and ease of navigation will be used to improve official Ubuntu documentation.
Discussion
I feel that this is something Ubuntu strives to be best at, the more work that is done to improve the ease of which new users can switch to Ubuntu the better in my opinion. It would be really good if the people who work on the above suggestions try to keep the DocumentationTeam in the loop as much as possible. Often late in development things like the above can change making parts of our documentation redundant/incorrect, which was defiantly an issue during Breezy development. The only other thing I would like to add is that not only should the above be evaluated, but people such as regular forum users, people who help out on IRC often and docteam people like myself are also good sources of knowledge on what things could be made easier, so pick our brains too! - RobertStoffers
Part of this spec is unimplementable: we shouldn't and can't force people who write private resources to stop hosting them and/or redirect their webpages to official sites. We've tried to talk the question over with the maintainers of the guide at this forum thread. (mdke)
Further, the statement that blunt non-graphical solutions are not useful ignores the userbase: almost every user I've had feedback from about the current official docs has stated that they preferred CLI based solutions. We need to reconcile this with a desire to focus on graphical solutions for those who like them. (mdke)
EvaluateUbuntuGuide (last edited 2009-03-11 16:52:10 by webdefence)