ubuntu-manual team mailing list archive

[Joe Burgess <joemburgess@xxxxxxxxx>]

Ch 1 & 2 => prologue

Ch 3 => Ch 1
Anthing on which version, goes to Ch. 10

Gnome part of Ch. 4 => Ch 2
Plus stuff on nautilus

Ch.3 Titled Applications contains
Rhytmbox
F-Spot
OpenOffice
Tomboy
Empathy
Firefox
Evolution
Totem
ubuntu one

Include a note on restricted extras when it first comes up

Ch. 4 Settings (Pretty much key parts in the system menu)
Setting up Printers
changing Users
Configuring Desktop Effects
Configure appearance (themes)
Configure screensaver/wallpaper
Display

Ch. 5 is just the applications section of old ch. 4 expanded a bit

Ch. 6 is pretty much old ch 6 without the cleaning up packages bit
(there is no proper gui for it) and also will include backup (with
TimeVault)

Ch 7 is the introduction to the terminal part of old ch. 7.

Ch 8 is old ch 10

Ch 9 Learning more about Linux and Extra Applications is new chapter on learning more and getting more help.  It also includes choosing a version, and talks about the other derivatives of Ubuntu.  It will also have the extra apps list (no detail, just list and link)
Cheese
The GIMP
Gnome Do
Google Chrome
Jokosher Audio Editor
Pitivi
Sun Virtualbox
VLC
Wine

-- 
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: In Progress

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?