[comment] XMLHttpRequest Object - clarity of language

Hi,

This is a QA Review comment for "The XMLHttpRequest Object"
http://www.w3.org/TR/2006/WD-XMLHttpRequest-20060405/
Wed, 05 Apr 2006 17:02:33 GMT
First WD

Be sure to be clear in terms you are using

[[[
A more complete description of what can be done with XMLHttpRequest  
can be found in the IDL below and its associated details.
]]]
-- The XMLHttpRequest Object
http://www.w3.org/TR/2006/WD-XMLHttpRequest-20060405/#xmlhttprequest
Wed, 05 Apr 2006 17:02:33 GMT


What is IDL? say it. "Interface Definition Language"

DOM 3 Core, that you reference, is using OMG IDL. Maybe that would be  
a good choice considering you are referring to Dom Core as well.

[[[
[OMG IDL]
     "OMG IDL Syntax and Semantics" defined in The Common Object  
Request Broker: Architecture and Specification, version 2, Object  
Management Group. The latest version of CORBA version 2.0 is  
available at http://www.omg.org/technology/documents/formal/corba_2.htm.
]]]

-- References
http://www.w3.org/TR/DOM-Level-3-Core/references.html#OMGIDL
Mon, 05 Apr 2004 19:37:31 GMT

There are also a few typos in the document.


-- 
Karl Dubost - http://www.w3.org/People/karl/
W3C Conformance Manager, QA Activity Lead
   QA Weblog - http://www.w3.org/QA/
      *** Be Strict To Be Cool ***

Received on Wednesday, 12 April 2006 06:45:34 UTC