W3C home > Mailing lists > Public > public-webapi@w3.org > June 2007

Re: Another XMLHttpRequest draft

From: denis sureau <scriptet@gmail.com>
Date: Thu, 28 Jun 2007 12:36:01 +0200
Message-ID: <eb81e42b0706280336t3de0d7cejd550b0c1e154797e@mail.gmail.com>
To: public-webapi@w3.org
I have just achieved the translation in french.
I dont know if this is regarded as a contribution, but I have noticed some
inacuracies...

Users agents become a single one:

   Conforming user agents must support some version of DOM Events and DOM
Core, because this specification uses some of the features defined in those
specifications. [DOM3Events] [DOM3Core]
    (...)
   It must also support some version of...

And also:

   Conforming user agents must support some version of the HTTP protocol.
The user agent should support...

Which value?

    The XML response entity body is either a Document representing the
response entity body or null and is determined by running the following
algorithm (the return value is its value):

One or several specs?

   ...set forth  in the XML specification
   (...)
    Parse the response entity body following the rules from the XML
specifications

Not clear what you mean by bubbling:

    ...is  dispatched on it during the bubbling phase

Should not contain a "format" but a string instead:

   If stored url just contains the "user" format let stored user be the user
part.

Some commas may improve the readability:

  If the user argument was not omitted and its syntax does not match that
specified by the relevant authentication scheme raise a SYNTAX_ERR exception
and terminate these steps.

By the "user" argument?

   This step overrides any user that may have been set by the url argument.

"Method" word missing:

Note that this algorithm might get aborted if the open() or abort() is
invoked.

Wording:

     If no Content-Type header is in the list of request  headers append it
to the list of request headers

Comma required:

   If the data argument has been omitted or is null no entity body is used
in the request.

"Error" word missing, and comma also:

  In case of DNS errors or other type of networks run the following set of
steps.


I don't know if its regarded as a contribution but I have an advice. The
removal of descriptions of the methods, replaced by just an algorithm is not
an improvement for some users, as students for example, that may use the
spec as a reference...


Denis Sureau: http://www.xul.fr
Received on Thursday, 28 June 2007 10:36:21 GMT

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