RE: XML schema comments

Hello,

Thanks Rinke. I'll implement right away your comments about the ordering of various productions: it is clearly a good idea for the
productions to be ordered in exactly the same way as in the Syntax document.

The only comment I don't necessarily agree is regarding the order of elements inside assertions. In the Syntax document, we've used
the order that is compatible with first-order logic: predicates come before the arguments. Thus, in class assertions we have the
class expressions before the individuals, and in property assertions we have the property, then the source, and then the target
individual. I'd prefer keeping things this way.

Regards,

	Boris

> -----Original Message-----
> From: public-owl-wg-request@w3.org [mailto:public-owl-wg-request@w3.org] On Behalf Of Rinke Hoekstra
> Sent: 27 August 2008 11:49
> To: Boris Motik
> Cc: 'OWL 2'; 'Sandro Hawke'
> Subject: Re: XML schema comments
> 
> 
> Hi Boris,
> 
> Ok, thanks! I've entered my review comments.
> 
> Best,
> 
> 	Rinke
> 
> On 27 aug 2008, at 09:53, Boris Motik wrote:
> 
> > Hello,
> >
> > {{LT}}!-- comment --> has been introduced by Sandro in order to make
> > the document pass HTML validation. I once changed it into <
> > but then Sandro complained. Perhaps he can shed some more light on
> > why this is necessary.
> >
> > Regarding comments, I guess you can just add them as usual. The
> > problems with rendering might then make us handle the comments
> > sooner rather than later. :-)
> >
> > Boris
> >
> >> -----Original Message-----
> >> From: public-owl-wg-request@w3.org [mailto:public-owl-wg-request@w3.org
> >> ] On Behalf Of Rinke Hoekstra
> >> Sent: 27 August 2008 09:38
> >> To: OWL 2
> >> Subject: XML schema comments
> >>
> >>
> >> Hi Peter, Boris, Bernardo,
> >>
> >> I am just finishing my review of the XML serialisation, and noticed
> >> that the original OWL_XML_Schema page contains comments (in the
> >> source), which do not show up in HTML on the Wiki.
> >>
> >> Most XML comments lines have the following form:
> >> {{LT}}!-- comment -->
> >>
> >> To improve readability of the schema, I suggest to replace them with:
> >> <!-- comment -->
> >>
> >> which makes them show up in the HTML rendering.
> >> If you're ok with it, I could make the changes to the schema document
> >> (on the wiki).
> >>
> >> Furthermore, I was wondering how you would like my review comments to
> >> be added? The {[Review|~~~~|comment}} template interrupts the
> >> rendering of the schema (and the hide review button only shows up on
> >> the XML Serialization page, not on OWL_XML_Schema). Other options is
> >> to put all comments in front of the schema, or add them inline as XML
> >> comments.
> >>
> >> -Rinke
> >>
> >> -----------------------------------------------
> >> Drs. Rinke Hoekstra
> >>
> >> Email: hoekstra@uva.nl    Skype:  rinkehoekstra
> >> Phone: +31-20-5253499     Fax:   +31-20-5253495
> >> Web:   http://www.leibnizcenter.org/users/rinke
> >>
> >> Leibniz Center for Law,          Faculty of Law
> >> University of Amsterdam,            PO Box 1030
> >> 1000 BA  Amsterdam,             The Netherlands
> >> -----------------------------------------------
> >>
> >>
> >>
> >>
> >
> 
> -----------------------------------------------
> Drs. Rinke Hoekstra
> 
> Email: hoekstra@uva.nl    Skype:  rinkehoekstra
> Phone: +31-20-5253499     Fax:   +31-20-5253495
> Web:   http://www.leibnizcenter.org/users/rinke
> 
> Leibniz Center for Law,          Faculty of Law
> University of Amsterdam,            PO Box 1030
> 1000 BA  Amsterdam,             The Netherlands
> -----------------------------------------------
> 
> 
> 
>

Received on Wednesday, 27 August 2008 10:12:05 UTC