← Back to team overview

ubuntu-manual team mailing list archive

Re: [Bug 504668] Re: Ordering of content might need some tweaking

 

Agreed


*
*
2010/1/10 Martin Kaba <kanute@xxxxxxxxxxxxxx>

> - Vish is right when he says  "There is a profound fear among new users
> that Linux==terminal knowledge is a must. Not mentioning the terminal or
> giving it importance in the simple guide will ease the user's fear a bit."
> I think the more you get used to Ubuntu the more you like the CLI,
> beginners will discover it,  each one at his/her own pace.
>
> - We don't need to go through every single application that's in the
> default install. Right!!! and if we have to mention extra applications
> they have to be found in the "Ubuntu Software Center" - easy-to-install-
> apps, by the way nobody is mentioning Ubuntu One.
>
> - For the rest I buy Ilya's second proposal
>
> --
> 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?
>
>
>
> _______________________________________________
> Mailing list: https://launchpad.net/~ubuntu-manual<https://launchpad.net/%7Eubuntu-manual>
> Post to     : ubuntu-manual@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~ubuntu-manual<https://launchpad.net/%7Eubuntu-manual>
> More help   : https://help.launchpad.net/ListHelp
>

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





References