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

Re: [comment] XMLHttpRequest Object - Class of Products

From: Anne van Kesteren <annevk@opera.com>
Date: Sun, 14 May 2006 13:23:43 +0200
To: "Karl Dubost" <karl@w3.org>
Cc: "Web APIs WG (public)" <public-webapi@w3.org>
Message-ID: <op.s9jgltmv64w2qv@id-c0020.oslo.opera.com>

On Wed, 26 Apr 2006 07:15:12 +0200, Karl Dubost <karl@w3.org> wrote:
>>> [[[
>>> Clearly identify the class of products (i.e., type of products or  
>>> services) upon which the requirements are imposed.  If multiple  
>>> classes of products are targeted by the specification, make sure each  
>>> is described.   Examples of classes of products include: content,  
>>> producer of content, player, protocol, API, agent, and guidelines.
>>> ]]] - http://www.w3.org/TR/qaframe-spec/#implement-principle
>>>
>>>
>>> It might be important for the Conformance section at a latter stage  
>>> and for the Test suite.
>>
>> I believe this is a duplicate of a comment http://www.w3.org/mid/ 
>> 63158BD4-C561-48D7-A801-1DAF64994BE6@w3.org you e-mailed just a bit  
>> earlier about our conformance model. I have not yet addressed that  
>> comment as I haven't specified the classes of products yet. If this is  
>> not a duplicate of that comment, please elaborate.
>
> It is related yet. Defining the class of products is very important to  
> write the specifications, more than the other way around. It should be  
> done at the start. In the Introduction it helps also to remind the scope  
> of the specification.
>
> So there's a need for the Conformance Section and a need for the Scope  
> section.

I tend to agree, but both of your comments where about the missing classes  
of products in the Conformance section. ;-)


-- 
Anne van Kesteren
<http://annevankesteren.nl/>
<http://www.opera.com/>
Received on Sunday, 14 May 2006 11:23:51 GMT

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