Comments on daml-s 0.7 (Service)

David,

The parser's view of Service.daml is lacking human-readable comments.
To illustrate, note the "See comments above" comments that are not helpful
in the following machine view of the Service.daml file:

triple("file:Service.daml",
"http://www.w3.org/1999/02/22-rdf-syntax-ns#type",
"http://www.daml.org/2001/03/daml+oil#Ontology")
triple("file:Service.daml",
"http://www.daml.org/2001/03/daml+oil#versionInfo", literal("
    $Id: Service.daml,v 1.7 2002/09/05 07:48:13 martin Exp $
  "))
triple("file:Service.daml", "http://www.w3.org/2000/01/rdf-schema#comment",
literal("
    Top level of DAML ontology for services.
    Part of the DAML-S ontology; see http://www.daml.org/services/.  
  "))
triple("file:Service.daml#Service",
"http://www.w3.org/1999/02/22-rdf-syntax-ns#type",
"http://www.daml.org/2001/03/daml+oil#Class")
triple("file:Service.daml#Service",
"http://www.w3.org/2000/01/rdf-schema#label", literal("Service"))
triple("file:Service.daml#Service",
"http://www.w3.org/2000/01/rdf-schema#comment", literal("See comments
above")) <<<--- hmmm
triple("file:Service.daml#ServiceProfile",
"http://www.w3.org/1999/02/22-rdf-syntax-ns#type",
"http://www.daml.org/2001/03/daml+oil#Class")
triple("file:Service.daml#ServiceProfile",
"http://www.w3.org/2000/01/rdf-schema#label", literal("ServiceProfile"))
triple("file:Service.daml#ServiceProfile",
"http://www.w3.org/2000/01/rdf-schema#comment", literal("See comments
above"))  <<<--- hmmm
triple("file:Service.daml#ServiceModel",
"http://www.w3.org/1999/02/22-rdf-syntax-ns#type",
"http://www.daml.org/2001/03/daml+oil#Class")
triple("file:Service.daml#ServiceModel",
"http://www.w3.org/2000/01/rdf-schema#label", literal("ServiceModel"))
triple("file:Service.daml#ServiceModel",
"http://www.w3.org/2000/01/rdf-schema#comment", literal("See comments
above")) <<<---- hmmm
triple("file:Service.daml#ServiceGrounding",
"http://www.w3.org/1999/02/22-rdf-syntax-ns#type",
"http://www.daml.org/2001/03/daml+oil#Class")
triple("file:Service.daml#ServiceGrounding",
"http://www.w3.org/2000/01/rdf-schema#label", literal("ServiceGrounding"))
triple("file:Service.daml#ServiceGrounding",
"http://www.w3.org/2000/01/rdf-schema#comment", literal("See comments
above"))  <<<---- hmmmm
... (more output follows ) ...

To fix: Recommend you split out the large comment in <!-- --> and make it
into a separate URI. Then, change the comment text to a CDATA section
referring you to the URI containing the large comment. This will serve
both human implementors (who need to refer to the comment text
while working with the Ontology) and will not burden automated agents
with too much extra information they can not use.

- Nick -


> 	WARNING: All e-mail sent to or from this address will be received or
> otherwise recorded by the Charles Schwab corporate e-mail system and is
> subject to archival, monitoring or review by, and/or disclosure to someone
> other than the recipient.
> 
> 

Received on Monday, 3 February 2003 16:16:39 UTC