ubuntu-manual team mailing list archive
-
ubuntu-manual team
-
Mailing list archive
-
Message #00241
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