Re: XML schema comments

Rinke Hoekstra wrote:
[snip]
>> 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).
> 

I must admit I sympathize with Rinke's, as well as Alan's view[1] on
this. I look at the func. syntax from an RDF user's point of view and,
well, I must admit that I continuously get confused by the order of the
arguments (as well as the names, I must say).

Having said that, syntax is very often a matter of taste, which means
there is no real right or wrong...

Ivan

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

-- 

Ivan Herman, W3C Semantic Web Activity Lead
Home: http://www.w3.org/People/Ivan/
PGP Key: http://www.ivan-herman.net/pgpkey.html
FOAF: http://www.ivan-herman.net/foaf.rdf