Re: Comments on daml-s 0.7 (Service)

Nick -

Thanks for pointing this out.  Yes, we do still have some comments that aren't
helpful from the tool user's perspective.  In recent upgrades, we have tried to
to avoid this.  But we also need to fix all the older comments, as you suggest,
and I've added this to our "to do" list.

Thanks again,
David

"Efthymiou, Nick" wrote:

> 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 Tuesday, 4 February 2003 16:14:58 UTC