ubuntu-manual team mailing list archive

[Joe Burgess <joemburgess@xxxxxxxxx>]

The terminal really is a place where only people are really into linux
go.  The idea of splitting up the book into the two sections is very
smart and what is required so that we can give a user a quick overview
of everything, keeping in mind that they don't care about a lot of
advanced topics.  For many people, their Ubuntu box is a media player
that does internet stuff, and I think that really is the crowd we are
aiming at.

I think Ilya's ch 1-5 make sense, but chapter 6 might be a little crazy.
Going over EVERY item in the applications list is crazy, it should be
more like selected applications, that are installed by default.  I have
figure out how to do such commands as sudo apt-get clean from the GUI
(using computer janitor) and I also think we need to include backup in
the maintenance section. There are plenty of GUI options, and we just
need to choose one and roll with it.  I propose TimeVault to be used for
that.

Now the key is we need to contact all of the current writers of the
chapters, and tell them about the new chapter changes (assuming we go
through with them) which at this point and time, might be a little hard,
but not ridiculous. Because of all the extra media attention we have
received, we have the people and some of these chapters seem to be
created such that multiple people can work on the same chapter.

My vote is to go for it.

-- 
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?