ubuntu-manual team mailing list archive

[Benjamin Humphrey <humphreybc@xxxxxxxxx>]

I like Ilya's second proposal, but Joe is right - we don't need to go
through every single application that's in the default install.

I don't like how our whole advanced section is condensed into two
chapters though. We need to combine some of the middle stuff and then
have it balance out, maybe something like 7:3 or 6:4.

Perhaps:

Prologue and About Ubuntu
1. Installation
2. Introduction to the Gnome desktop
3. Internet, Emails and IM
4. Settings and external devices
5. Software and Packaging
6. System Maintenance
7. Using the Terminal
8. Troubleshooting common problems
10. Learning more about Linux and Extra Applications

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