RE: Your comments on Device Description Repository Simple API ( LC-1958)

I accept this response
________________________________________
De: rotan.hanrahan@mobileaware.com [rotan.hanrahan@mobileaware.com]
Enviado el: jueves, 29 de mayo de 2008 17:54
Para: JOSE MANUEL CANTERA FONSECA
CC: public-ddwg-comments@w3.org
Asunto: Re: Your comments on Device Description Repository Simple API ( LC-1958)

 Dear José Manuel Cantera ,

The Mobile Web Initiative Device Description Working Group has reviewed
the comments you sent [1] on the Last Call Working Draft [2] of the Device
Description Repository Simple API published on 4 Apr 2008. Thank you for
having taken the time to review the document and to send us comments!

The Working Group's response to your comment is included below, and has
been implemented in the new version of the document available at:
http://www.w3.org/2005/MWI/DDWG/drafts/api/080529.

Please review it carefully and let us know by email at
public-ddwg-comments@w3.org if you agree with it or not before 9 June
2008. In case of disagreement, you are requested to provide a specific
solution for or a path to a consensus with the Working Group. If such a
consensus cannot be achieved, you will be given the opportunity to raise a
formal objection which will then be reviewed by the Director during the
transition of this document to the next stage in the W3C Recommendation
Track.

Thanks,

For the Mobile Web Initiative Device Description Working Group,
Matt Womer
W3C Staff Contact

 1.
http://www.w3.org/mid/93AA9E47B82F684A868C217766F489050397FB9F0D@EXCLU2K7.hi.inet
 2. http://www.w3.org/TR/2008/WD-DDR-Simple-API-20080404/


=====

Your comment on :
> Regarding http://www.w3.org/TR/2008/WD-DDR-Simple-API-20080404/JavaDoc/
> the following problems have been detected
>
> -> Interface DDRException
>
> * "code" field description is empty
>
> ->
>
PropertyValues<http://www.w3.org/TR/2008/WD-DDR-Simple-API-20080404/JavaDoc/org/w3c/ddr/simple/PropertyValues.html>
>
getPropertyValues(Evidence<http://www.w3.org/TR/2008/WD-DDR-Simple-API-20080404/JavaDoc/org/w3c/ddr/simple/Evidence.html>
> evidence)
>
> the "returns" section has a wrong description. It should say "Returns
> all available values for the evidence supplied"
>
> -> PropertyRef newPropertyRef(String localPropertyName) throws
> NameException.
>
> "localPropertyName" parameter description is empty
>
> -> PropertyRef newPropertyRef(PropertyName propertyName) throws
> NameException
>
> "propertyName" parameter description is empty
>
> -> PropertyRef newPropertyRef(PropertyName propertyName, String
>
> localAspectName) throws NameException.
>
>
>
> "propertyName", "localAspectName" parameters description are empty


Working Group Resolution (LC-1958):
The JavaDoc has been completed in line with this and other comments.

----

Received on Thursday, 29 May 2008 16:12:17 UTC