Re: XML schema comments

Hi Boris,

On 27 aug 2008, at 12:10, Boris Motik wrote:
> 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.

Good! :)

> 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.

I guess, FOL syntax aside, it depends on the perspective you have on  
what a ClassAssertion means: either you're saying something about a  
class, or you're saying something about an individual. Even though  
they mean the same thing, the former is more intuitive from a FOL/DL  
perspective, but the latter is more intuitive to users (cf. the  
individuals tab in Protege).

I remember Alan mentioning something similar once as well in [1]  
(though I think the PSO vs SPO distinction is less confusing).

Best,

	Rinke

[1] http://lists.w3.org/Archives/Public/public-owl-wg/2008May/0191.html


> 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
>> -----------------------------------------------
>>
>>
>>
>>
>
>

-----------------------------------------------
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:23:34 UTC