Explanations in guides

Phil Bull philbull at gmail.com
Tue Oct 23 20:13:09 UTC 2007


Hi Vadim,

On Tue, 2007-10-23 at 15:51 -0400, Vadim Peretokin wrote:
> Would it be alright if I put the commands first, and then said "The
> file was extracted and moved into the Firefox plug-ins directory."? I
> think that would be much less confusing to a lot of people.

That sounds good, please go ahead!

Also, please try to explain what the command does when its used if
possible. That way, people can be more confident in using the commands
and may be able to troubleshoot problems more effectively themselves. If
instructions contain commands without explanations, inexperienced users
don't know what's going on and it feels like they're typing in some
crazy, incomprehensible magic language.

As an example:

 1. Type "tar -zxf install_flash_player_9_linux.tar.gz" into the
Terminal. This extracts the Flash Player package to the current
directory.
 2. Type "sudo mv install_flash_player_9_linux/libflashplayer.so
/usr/local/firefox32/plugins/". This moves the Flash Player plugin to a
shared directory, which allows other users on the computer to use the
plugin too.

Thanks,

Phil

-- 
Phil Bull
http://www.launchpad.net/people/philbull





More information about the ubuntu-doc mailing list