RE: XML schema comments

Hello,

I've addressed Rinke's comments in the XML Syntax. The order of all elements is now *exactly* the same as in the Syntax document.
Furthermore, I've introduced element groups for tagging interfaces such as ObjectPropertyAxiom from the structural spec. Finally,
I've fixed the comments and the document seems to validate properly now (perhaps this is a new Wiki version?).

I haven't addressed the clarity issues in the introduction, though.

Thanks again for these comments!

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 11:17:38 UTC