Re: Reference document: a review

At 19:49 +0100 1/2/03, herman.ter.horst@philips.com wrote:
>In today's telecon we discussed the desire to make the reference 
>document  more
>completely realize its function as a reference for the syntax of the language.
>
>I want to make a suggestion that makes more concrete the comments I already
>made in this direction in my review of this document at [1].
>This review mentions that many sections do already contain more or 
>less complete
>syntax descriptions, in the form of examples, but that in four 
>important sections
>such syntax descriptions are missing:
>class elements, class expressions, property restrictions, property elements.
>
>A simple way to fill this gap would be to simply copy several 
>syntactic examples from
>the Guide document to these four sections.  I mean only the syntax, not the
>ontology discussions surrounding it, of course.
>Then the effort that went/goes in these examples is used twice.
>Although the Guide itself is not convenient to use as a reference 
>for language syntax,
>several of its examples could also be used in the reference document.
>
>Herman ter Horst
>Philips Research
>
>[1] http://lists.w3.org/Archives/Public/www-webont-wg/2002Dec/0256.html

I didn't think these were such omissions, mainly because they were in 
the Guide.  This might be a good place for cross reference, rather 
than for providing the examples in the Ref doc

-- 
Professor James Hendler				  hendler@cs.umd.edu
Director, Semantic Web and Agent Technologies	  301-405-2696
Maryland Information and Network Dynamics Lab.	  301-405-6707 (Fax)
Univ of Maryland, College Park, MD 20742	  240-731-3822 (Cell)
http://www.cs.umd.edu/users/hendler

Received on Thursday, 2 January 2003 17:04:25 UTC