ubuntu-manual team mailing list archive

[tacantara <tacantara@xxxxxxxxx>]

One of the best things (IMO) that separates Ubuntu from Windows is the
flexibility offered by the CLI.  I personally wish I knew more about it,
but I'm taking the time to do just that.  GUI is a good way to break in
new users, but we can't push the CLI into the area of "advanced
operations."  That particular topic should be introduced as soon as
possible.  Once new users become comfortable with the CLI, they can
start experimenting with scripting, etc., as I have in the past year
since I started using Ubuntu.

-- 
Ordering of content might need some tweaking
https://bugs.launchpad.net/bugs/504668
You received this bug notification because you are a member of Ubuntu
Manual Team, which is a bug assignee.

Status in Ubuntu Manual: Confirmed

Bug description:
I have been taking a look at our current TOC and am wondering whether it needs to be tweaked slightly. My concern is that we will be asking users to open a terminal and type commands within the first six chapters, however it is not until chapter 7 that we have an 'introduction to the terminal' that explains what it is and what sudo means etc. This doesn't make sense to me and could be confusing/offputting to a beginner.

My suggestion is this:

1. Rename chapter 6 to simply "Updates and Upgrades", and remove the section on "system maintenance".
2. Rename chapter 7 to "System Maintenance", and make the content on system maintenance (that was in chapter 6) a new subsection of chapter 7, following the 'introduction to the terminal' subsection.

That way, I think we could almost get away with not using the command line at all for the entire first part of the manual, as it's mostly gui-based stuff. Then when the reader gets to part II - advanced, the first thing they read is an introduction to the terminal.

Hope that all made sense. Anyone have any other suggestions?