W3C home > Mailing lists > Public > public-owl-wg@w3.org > August 2008

Re: XML schema comments

From: Rinke Hoekstra <hoekstra@uva.nl>
Date: Wed, 27 Aug 2008 11:48:58 +0200
Cc: "'OWL 2'" <public-owl-wg@w3.org>, "'Sandro Hawke'" <sandro@w3.org>
Message-Id: <E0FCECBE-E070-4C82-A7CE-6B0446A9AD82@uva.nl>
To: Boris Motik <boris.motik@comlab.ox.ac.uk>

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 &lt;
> 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:
>> &lt;!-- comment --&gt;
>>
>> 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 09:49:35 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 27 August 2008 09:49:36 GMT