W3C home > Mailing lists > Public > public-webapi@w3.org > February 2008

Re: [XHR] Editorial - labelling sections

From: Charles McCathieNevile <chaals@opera.com>
Date: Mon, 18 Feb 2008 11:50:59 +0100
To: "Anne van Kesteren" <annevk@opera.com>, "Web API WG (public)" <public-webapi@w3.org>
Message-ID: <op.t6pu29iowxe0ny@widsith.lan>

On Wed, 13 Feb 2008 01:28:46 +0100, Anne van Kesteren <annevk@opera.com>  
wrote:

> On Tue, 12 Feb 2008 20:01:30 +0100, Charles McCathieNevile  
> <chaals@opera.com> wrote:
>> working through the first test case I looked at, sections of the  
>> document seem to be quite large. I believe it would be helpful if there  
>> were a more granular breakdown of sections, and a more detailed table  
>> of contents, in order to refer in more detail to important parts of the  
>> spec.
>
> This is changed in XMLHttpRequest Level 2. I rather not change the whole  
> structure for XMLHttpRequest Level 1 as we've had this structure since  
> the beginning and changing it will be quite some editorial work with a  
> high risk of introducing errors. Each member of the interface has a  
> unique identifier so you can easily point to them.

You mean in the source? If so, putting in an expanded table of contents  
somewhere that links in more detail, so I could see and copy/paste the  
relevant link without reading the source would be extremely helpful.

cheers

Chaals

-- 
Charles McCathieNevile  Opera Software, Standards Group
     je parle français -- hablo español -- jeg lærer norsk
http://my.opera.com/chaals   Try Opera 9.5: http://snapshot.opera.com
Received on Monday, 18 February 2008 10:52:19 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 18 February 2008 10:52:20 GMT