W3C home > Mailing lists > Public > public-webapi@w3.org > April 2006

[comment] XMLHttpRequest Object - clarity of language

From: Karl Dubost <karl@w3.org>
Date: Wed, 12 Apr 2006 15:44:53 +0900
Message-Id: <F3C0977B-958B-4CB2-9819-44B4DD8120BA@w3.org>
To: public-webapi@w3.org

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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:18:54 GMT