some editorial comments on appendix B of CC/PP S&V WD

DIWG, All,

Appendix B in the CC/PP Struct&Voc WD (specifying the RDF schema for the
CC/PP structure) contains some errors.
See attached comments.

Best Regards,
Francesco Cannistrà

-----------
-----------

1. Section B.2

[[Structural properties (instances of ccpp:Property)]]

Maybe it is more proper to replace "instances of ccpp:Property" with
"instances of ccpp:Structure".

2. Section B.2, figure B-3

It is indicated a no-more existing ccpp:Client-profile class as domain of
ccpp:component.

3. Section B.3, figure B-4

In the comment for ccpp:Profile the last sentence should be deleted since it
references concepts of the no-more existing proxy-behaviour spec:

"May be a Request-profile or a Client-profile."

4. Section B.3, figure B-4

The comment for ccpp:Component does not make sense since it references
concepts of the no-more existing proxy-behaviour spec.

5. Section B.3, figure B-4

The comment for ccpp:Property starts with the sentence:

"All property arcs that constitute parts of a CC/PP profile are defined as
subclasses of ccpp:Property."

This is not correct because the RDF graph resulting from a CC/PP profile
could contain lot of other arcs (e.g., arcs for rdf:type properties, arcs
for rdf:li or rdf:_n properties, arcs for properties of an attribute value
expressed through an arbitrary RDF resource etc.). Furthermore, the
properties corresponding to the  intended property arcs would not be
"subclasses of ccpp:Property" but they would be instances of ccpp:Property.

6. Section B.3, figure B-4

The comment for ccpp:Structure starts with the phrase:

"All property arcs that relate the structural elements of a CC/PP profile
are declared as instances of ccpp:Structure."

I don't think this wording conform rigorously to the RDF semantics, since it
makes confusion between property resources and property arcs (they are not
the same thing). A property resource is an RDF resource (i.e. an instance of
a RDF class) that defines an RDF property, while a property arc  represents
a statement (it is, in some sense, an instantiation or a declaration of an
RDF property).
A quite correct wording could be attained be simply deleting "arcs" and by
replacing "property" with "properties" and "are declared" with "are defined"
(the "declaration" of a property calls for the construction of a statement):

"All properties that relate the structural elements of a CC/PP profile are
defined as instances of ccpp:Structure."

An analogous wording is used in the comment for ccpp:Attribute:

"All property arcs that represent client capabilities or preferences in a
CC/PP profile are declared as instances of ccpp:Attribute."

Here a correct wording  would be attained by replacing "property arcs" with
"properties", "represent" with "describe" and "are declared" with "should be
defined":

"All properties that describe client capabilities or preferences in a CC/PP
profile should be defined as instances of ccpp:Attribute."

Received on Saturday, 30 August 2003 09:44:24 UTC