[Bug 16301] New: editorial - ambiguous language

https://www.w3.org/Bugs/Public/show_bug.cgi?id=16301

           Summary: editorial - ambiguous language
           Product: WebAppsWG
           Version: unspecified
          Platform: All
               URL: http://dvcs.w3.org/hg/xhr/raw-file/8d4e9ccfdbd4/Overvi
                    ew.html#the-send()-method
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: XHR
        AssignedTo: annevk@opera.com
        ReportedBy: glenn@skynav.com
         QAContact: public-webapps-bugzilla@w3.org
                CC: mike@w3.org, public-webapps@w3.org


In section 4.7.6 step 3 under "If data is a Document", the following sentence:

"Let mime type be "application/xml" or "text/html" if Document is an HTML
document, followed by ";charset=", followed by encoding."

is ambiguous since it can be read either as

A: Let mime type be ( "application/xml" or "text/html" ) if Document is an HTML
document ...

or as

B: Let mime type be "application/xml" or ( "text/html" if Document is an HTML
document ) ...

suggest rephrasing as follows:

"If Document is an HTML document, then let mime type be "text/html" followed by
";charset=" followed by encoding; otherwise, let mime type be
"application/xml".

an even more simplified form would be:

"If Document is an HTML document, then let mime type be
"text/html;charset=encoding"; otherwise, let mime type be "application/xml"."

in this case encoding should be set in italic to denote it is a variable
corresponding to the same-named variable in the previous paragraph

-- 
Configure bugmail: https://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.

Received on Saturday, 10 March 2012 04:11:22 UTC