ubuntu-manual team mailing list archive
-
ubuntu-manual team
-
Mailing list archive
-
Message #04506
Re: Authoring of "getting online" done
Hi David,
Good question! Whether a word should be explained in the glossary or not
is a choice of the author or editor. Personally I think switch is rather
technical and does not need to be explained in a beginners' guide (just
my 2 cents).
Hannie
Op 18-09-13 17:05, David Manuel Pires schreef:
> Hi, Jim and team
>
> I'm currently in the process of reviewing the "getting online" section
> and noticed that at its very beginning (in the second paragraph) it is
> used a *_\gls_* tag associated with the term router, meaning that if
> someone needs to read an explanation of what a router is, when
> clicking the word is directly pointed to it's definition in the
> glossary, but there's no \gls tag associated with the term switch. Is
> there any specific explanation for this or is this just something that
> was forgotten?
>
> A definition of what a switch is should, IMHO, also be included in the
> Glossary section and its respective tag included throughout the manual.
> A possible definition could be something like:
> /A switch is a computer networking device that that data from any
> device connected to it and then transmits that data only to the device
> for which it was meant./
> /
> /
> What do you think?
>
> Regards,
> David Pires
>
>
> On 16 September 2013 00:47, Jim Connett <jimandmarcy@xxxxxxxxx
> <mailto:jimandmarcy@xxxxxxxxx>> wrote:
>
> Hey David and Carsten,
>
> The "getting online" section in the 13.10 Ubuntu manual is ready
> for review.
>
> Two notes:
> *GETTING ONLINE*
> [[ isues ]]
> Two screenshots in the margins next to "Establishing a wired
> connection" (figures 3.2, and 3.3) that need to be moved to the
> body of the text. Carsten, please make a note of this.
>
> I could not fully test the wireless section as I've Ubuntu
> installed in a VM that connects through a wire. Please test the
> latter portions of this section where it describes how to connect
> to a hidden wireless network as well as how to change wireless
> settings.
>
> Thanks
> --Jim
>
>
>
>
>
>
> _______________________________________________
> Mailing list: https://launchpad.net/~ubuntu-manual
> Post to : ubuntu-manual@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~ubuntu-manual
> More help : https://help.launchpad.net/ListHelp
Follow ups
References