PDA

View Full Version : Confusions in the User Guide


adamb10
November 12th, 2005, 12:11 AM
Hey all,
Since Ubuntu Guide 5.10 is not up and running I decided to use the starter guide to get the apps I needed. I have found many problems here...

1. I'm not a fan of synaptic. I love the command line version. I find it easier to use.

2. The guide doesn't tell you to killall gnome-panel. After the user installs an app there going to be wondering where it is.

3. It doesn't tell you when to use the command line. ex. I saw this in installing extra fonts...


#3 Rebuild the font information cache files

sudo fc-cache -f -v


While I know that command is Bash some newbies may not know.

Thats all for now.

manicka
November 12th, 2005, 02:46 AM
I know that you like the CLI, but the official help pages are pretty good, even if they use synaptic - http://help.ubuntu.com/starterguide/C/faqguide-all.html

Maybe you could just adjust these instructions and complete the tasks from the CLI. I'm assuming you're fairly comfortable with Linux and the CLI. It shouldn't be to big a task.

mattheweast
November 12th, 2005, 08:31 PM
Hi Adamb!

Thanks for this feedback. For future reference, please mail any comments you have about the starter guide to ubuntu-doc@lists.ubuntu.com. You can also file bugs in bugzilla in the normal way: that way we're sure to get them! The Documentation team doesn't check this forum regularly, it's for the ubuntuguide.org guide.

Hey all,
Since Ubuntu Guide 5.10 is not up and running I decided to use the starter guide to get the apps I needed. I have found many problems here...

1. I'm not a fan of synaptic. I love the command line version. I find it easier to use.


Fair enough. We will hopefully build in some instructions for using the command line in the next version.


2. The guide doesn't tell you to killall gnome-panel. After the user installs an app there going to be wondering where it is.


It is not necessary to kill the panel - since gnome 2.12 the panel automatically updates itself after installing applications.


3. It doesn't tell you when to use the command line. ex. I saw this in installing extra fonts...


Good feedback, thanks. The guide has a preface section in which it explains the conventions used, and this is one of them: but it is obviously not prominent enough. This is something we can work on.

Thanks again for your comments.