Technical Review: preparing.xml

[Thomas Roten]

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: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20080707/c10be193/attachment.pgp>