ubuntu-doc Digest, Vol 46, Issue 8

[Robert Bowman]

Let's get it on. Sugar. You know what I'm talkin bout
------------------------------------------------
Now, we must all fear evil men. But there is another kind of evil which we must fear most, and that is the indifference of good men. 
------------------------------------------------

-----Original Message-----
From: ubuntu-doc-request at lists.ubuntu.com

Date: Tue, 08 Jul 2008 12:00:11 
To: <ubuntu-doc at lists.ubuntu.com>
Subject: ubuntu-doc Digest, Vol 46, Issue 8


Send ubuntu-doc mailing list submissions to
	ubuntu-doc at lists.ubuntu.com

To subscribe or unsubscribe via the World Wide Web, visit
	https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
or, via email, send a message with subject or body 'help' to
	ubuntu-doc-request at lists.ubuntu.com

You can reach the person managing the list at
	ubuntu-doc-owner at lists.ubuntu.com

When replying, please edit your Subject line so it is more specific
than "Re: Contents of ubuntu-doc digest..."


Today's Topics:

   1. Technical Review:  preparing.xml (Thomas Roten)


----------------------------------------------------------------------

Message: 1
Date: Mon, 7 Jul 2008 23:37:13 -0400
From: Thomas Roten <thomasroten at tundrius.com>
Subject: Technical Review:  preparing.xml
To: ubuntu-doc at lists.ubuntu.com
Message-ID: <20080708033713.GA22312 at unendlich>
Content-Type: text/plain; charset="us-ascii"

This is my first Technical Review, so feel free to criticize any
mistakes I've made.  I am eager to learn about the Documentation Team,
so criticisms will help.

I reviewed all of the sections in the file titled "preparations.xml" under
the "windows" category.

Here are the issues that I found with some of the sections:

Section:  preparing-settings-internet-dialup
        Spelling of "user name" should be "username" according to
https://wiki.ubuntu.com/DocumentationTeam/StyleGuide/StandardTerminology
        Spelling of "dialling" should be "dialing" according to the
Style Guide (standard American English spelling only)

Section:  preparing-settings-internet-broadband
        Spelling of "user name" should be "username" according to
https://wiki.ubuntu.com/DocumentationTeam/StyleGuide/StandardTerminology
        Spelling of "dialling" should be "dialing" according to the
Style Guide (standard American English spelling only)
        Should be another comma before "or" in "DNS server, gateway IP
address or DHCP server"

Section:  preparing-settings-network-home
        Filename in step 4 is different from the one that it refers to
in step 3

Section:  preparing-settings-network-windows
        "There are several important pieces of information which you
should have to hand if you would like to connect to a wireless
network."  I assume this is supposed to be "have at hand".  But even
so, shouldn't we refrain from idioms so that translating is easier?
How about changing it to "There are several important pieces of
information which you should have if you would like to connect to a
wireless network."

Section:  preparing-settings-im
        "User name" should be "username" according to
https://wiki.ubuntu.com/DocumentationTeam/StyleGuide/StandardTerminology

Section:  preparing-bookmarks-ie
        The section is written for "Internet Explorer 6".  There
should probably be an update to it as IE7 was released in 2006.

Section:  preparing-bookmarks-ie, preparing-bookmarks-firefox, and
preparing-bookmarks-opera
        "To backup your BROWSER NAME web browser:"  Are we backing up
the web browser or the web browser bookmarks?  Should be changed to
"web browser bookmarks:"

Section:  preparing-email
        Typo:  "able to access it using the a web browser" should be
changed to "using a web browser"
        "from the Ubuntu Ubuntu community support website"  Is this
the correct syntax?  Or should there just be one "Ubuntu"?

Section:  preparing-email-msoe
        "from the Ubuntu Ubuntu community support website"  Is this
the correct syntax?  Or should there just be one "Ubuntu"?

Section:  preparing-email-import
        Is it necessary to specify "free, open-source"?  I don't think
it contributes to the information that is supposed to be conveyed.

Section:  preparing-storage-cddvd
        "labelled" and "labelling" should be "labeled" and "labeling"
respectively according to the Style Guide (standard American English
spelling only)


Let me know if there is anything else I should do with these sections
and corrections.

--
Thomas Roten
GPG Public Key:  http://www.tundrius.com/ThomasRoten.gpg
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
Url : https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20080707/c10be193/attachment-0001.pgp

------------------------------

--
ubuntu-doc mailing list
ubuntu-doc at lists.ubuntu.com
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc


End of ubuntu-doc Digest, Vol 46, Issue 8
*****************************************