EvaluateUbuntuGuide
|
Size: 5602
Comment: + Summary + Rationale + Use cases
|
Size: 5715
Comment: cleanup, ready for review
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 3: | Line 3: |
| * '''Launchpad entry:''' https://launchpad.net/distros/ubuntu/+spec/evalutate-ubuntu-guide | * '''Launchpad entry:''' https://launchpad.net/distros/ubuntu/+spec/evaluate-ubuntu-guide |
| Line 10: | Line 10: |
| Ubuntu Guide (ubuntuguide.org) was a valuable source of help for early versions of Ubuntu, but it is now out of date and unmaintained, and inappropriately concentrated on blunt non-graphical solutions. To solve this, redirecting the site to `help.ubuntu.com` will be investigated, and several feature goals will be registered to make some of the Guide's command-line hackery unnecessary. | Ubuntu Guide (ubuntuguide.org) was a valuable source of help for early versions of Ubuntu, but it is now out of date, and somewhat inappropriately concentrated on blunt non-graphical solutions. To solve this, the possibility of redirecting the site to `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 to make some of the Guide's command-line hackery unnecessary. |
| Line 16: | Line 16: |
| * The presence of many of the questions in the Guide are symptoms of missing, undiscoverable, or difficult and/or poorly documented features in Ubuntu. | * The Guide concentrates on command-line answers, making Ubuntu sometimes seem more difficult than it is. * The presence of many of the questions in the Guide are symptoms of missing, undiscoverable, or difficult and/or poorly documented features in Ubuntu itself. |
| Line 20: | Line 22: |
| * Jonathan switches from Kubuntu to Ubuntu. A couple of months later, his ISP changes their proxy server and he wants to know how to configure it in Ubuntu. So he searches the Web for "ubuntu proxy server". | * 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 24: | Line 26: |
| * Eun Park wants to know how to enter Korean text in Ubuntu. She searches at Yahoo Korea for "한국어 ubuntu". | * Eun Park wants to know how to enter Korean text in Ubuntu. She searches at Yahoo Korea for "ubuntu 한국어". |
| Line 26: | Line 28: |
| == Review == | == Implementation == |
| Line 28: | Line 30: |
| * Below is the format of the ["FAQGuide"] in BreezyBadger, for current work see DesktopGuide and ServerGuide | Once [http://help.ubuntu.com/ help.ubuntu.com] is working, the possibility of redirecting to it from `ubuntuguide.org` will be investigated. |
| Line 30: | Line 32: |
| Although the Ubuntu Guide (ubuntuguide.org) serves as a good source of information for users of how to achieve certain tasks, we need to make sure we can make it smaller - which means more tasks should be fully automated, and those that cannot, should be evaluated and refined to make them more easy and straight forward to follow. (possibly be merged into ubuntu's shipped starter's guide) | 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 36: |
| This section should be redundant with the front page of ubuntu.com. If it isn't, ubuntu.com needs redesigning. | This section should be redundant with the front page of [http://ubuntu.com/ ubuntu.com]. If it isn't, ubuntu.com needs redesigning (''see'' UbuntuWebSite). |
| Line 38: | Line 40: |
| Should be redundant with an Ubuntu CD, or with the top of the guide itself. | Should be redundant with an Ubuntu CD, or with the top of the guide itself (which should link to a PDF version). |
| Line 46: | Line 48: |
| ??? | This section is actually about installing Windows software, a topic that should have its own illustrated page on help.ubuntu.com. |
| Line 50: | Line 52: |
| Less necessary with `gnome-about-me` Should be mostly unnecessary once there is a unified Accounts control panel |
This is less necessary with the advent of `gnome-about-me`, and should be almost completely unnecessary once there is a unified AccountsControlPanel. |
| Line 57: | Line 57: |
| * Autoconfigure X including enablement of the drivers. * Automatically turning on DMA. * Look into why CDs sometimes don't unmount. * Improve support for Palm OS devices. |
|
| Line 60: | Line 64: |
| * Integrated CD burning and ripping: ''see'' JukeboxCentralization. * Integration of burning solution and image ripping solution. |
|
| Line 63: | Line 69: |
| First sections less necessary with NetworkMagic Dialup needs to be much easier Network folders problems? |
* The first sections will be less necessary with NetworkMagic. * Dialup needs to be much easier: ''see'' NonBroadbandUsers. * Sharing needs to be made easier (samba configuration ''etc''). |
| Line 70: | Line 75: |
| A dedicated guide should be written for this. |
|
| Line 71: | Line 78: |
* find Windows partition & mount them |
|
| Line 76: | Line 85: |
| GraphicalRescueMode needed? (like Windows "Safe Mode", but more guided?) GrubConfigRecovery |
* GraphicalRescueMode needed? (like Windows "Safe Mode", but more guided?) * GrubConfigRecovery |
| Line 83: | Line 92: |
| == Implementation == | * Corey needs to report a bug about "Empty Trash" really emptying the trash. |
| Line 85: | Line 94: |
| * `ubuntuguide.org` should redirect to `help.ubuntu.com`. | == Discussion == |
| Line 87: | Line 96: |
| === Need specs === * look into why cds sometimes don't unmount * palm os devices * integrated CD burning solution * easy sharing solution (samba configuration) * find Windows partition & mount them * graphical/curses rescue mode * Autoconfigure X including enablement of the drivers. * Automtic enablement of DMA. * Integration of burning solution and image ripping solution. === Need guides === * easy guide to remote desktop * Corey needs to report a bug about "Empty Trash" really emptying the trash. === Code === === Data preservation and migration === == Outstanding issues == == BoF agenda and discussion == Evaluate Ubuntu Guide, the forum howto's and the wiki pages to see what can be made easier to do in Ubuntu. * comment - Please note that the ubuntuguide has been evaluated, hacked up and integrated into Ubuntu by the documentation team. The "official" version of the guide is found by clicking "System->Help" and selecting "Starter Guide". It will also be available online. As for the wiki, the DocumentationTeam and WikiTeam are working hard on it. |
* The Ubuntu Guide was evaluated, hacked up and integrated into Ubuntu by the documentation team. The "official" version of the guide is found by clicking "System->Help" and selecting "Starter Guide". It will also be available online. As for the wiki, the DocumentationTeam and WikiTeam are working hard on it. |
| Line 117: | Line 99: |
| * comment - 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 | * 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 |
Launchpad entry: https://launchpad.net/distros/ubuntu/+spec/evaluate-ubuntu-guide
Created: Date(2005-10-06T20:59:08Z) by JaneWeideman
Contributors: JaneWeideman, MatthewPaulThomas, CoreyBurger
Packages: ubuntu-doc
Summary
Ubuntu Guide (ubuntuguide.org) was a valuable source of help for early versions of Ubuntu, but it is now out of date, and somewhat inappropriately concentrated on blunt non-graphical solutions. To solve this, the possibility of redirecting the site to 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 to make some of the Guide's command-line hackery unnecessary.
Rationale
- The Ubuntu Guide has not been updated recently, and some of the individual answers are no longer up to date, relevant or appropriate.
- The Guide concentrates on command-line answers, making Ubuntu sometimes seem more difficult than it is.
- The presence of many of the questions in the Guide are symptoms of missing, undiscoverable, or difficult and/or poorly documented features in Ubuntu itself.
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 [http://help.ubuntu.com/ help.ubuntu.com] is working, the possibility of redirecting to it 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.
Getting Started
This section should be redundant with the front page of [http://ubuntu.com/ ubuntu.com]. If it isn't, ubuntu.com needs redesigning (see UbuntuWebSite).
Getting UbuntuGuide
Should be redundant with an Ubuntu CD, or with the top of the guide itself (which should link to a PDF version).
Repositories; Ubuntu Updates; Add-On Applications
Should become unnecessary once RepositoryDialogDesign (and SoftwareManager) are implemented.
Commercial Applications
This section is actually about installing Windows software, a topic that should have its own illustrated page on help.ubuntu.com.
Users Administration
This is less necessary with the advent of gnome-about-me, and should be almost completely unnecessary once there is a unified AccountsControlPanel.
Hardware
- Spec graphical X configuration tool.
- Autoconfigure X including enablement of the drivers.
- Automatically turning on DMA.
- Look into why CDs sometimes don't unmount.
- Improve support for Palm OS devices.
CD/DVD burning
Integrated CD burning and ripping: see JukeboxCentralization.
- Integration of burning solution and image ripping solution.
Networking
The first sections will be less necessary with NetworkMagic.
Dialup needs to be much easier: see NonBroadbandUsers.
Sharing needs to be made easier (samba configuration etc).
Remote Desktop
A dedicated guide should be written for this.
Windows
find Windows partition & mount them
Security
Rescue Mode
GraphicalRescueMode needed? (like Windows "Safe Mode", but more guided?)
Tips & Tricks
Almost all of these are already covered in System > Preferences, or are workarounds for enhancements needed in upstream applications (e.g. the Boot Manager).
- Corey needs to report a bug about "Empty Trash" really emptying the trash.
Discussion
The Ubuntu Guide was evaluated, hacked up and integrated into Ubuntu by the documentation team. The "official" version of the guide is found by clicking "System->Help" and selecting "Starter Guide". It will also be available online. As for the wiki, the DocumentationTeam and WikiTeam are working hard on it.
- Reply: The point here is not to create/improve documentation, but evaluate what can be made easier so no guide will be needed. E.g. easier installation of nvidia/ati drivers (two recent howto's for ati drivers for breezy already have been viewed for more than 10,000 times together! And one already has over 100 replies. All this in 5 days!). Maybe it needs a better title.
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
EvaluateUbuntuGuide (last edited 2009-03-11 16:52:10 by webdefence)