W3C home > Mailing lists > Public > public-dxwg-comments@w3.org > February 2019

RE: Feedback on the Profiles Vocabulary - Definition and note of prof:hasToken

From: Makx Dekkers <mail@makxdekkers.com>
Date: Wed, 27 Feb 2019 12:52:07 +0100
To: "'public-dxwg-comments'" <public-dxwg-comments@w3.org>
Message-ID: <000001d4ce92$de92b290$9bb817b0$@makxdekkers.com>
I think the definition should not indicate use, that's for the usage note.

 

I would suggest:

 

Definition: "An alternative identifier for the Profile"

Usage Note: "To be used when the Profile's URI cannot be used, for example
in APIs or in content negotiation."

 

Makx.

 

From: Car, Nicholas (L&W, Dutton Park) <Nicholas.Car@csiro.au> 
Sent: 26 February 2019 22:15
To: public-dxwg-comments <public-dxwg-comments@w3.org>
Subject: Feedback on the Profiles Vocabulary - Definition and note of
prof:hasToken

 

From Heidi Vanparys via GitHub: https://github.com/w3c/dxwg/issues/723
regarding the Profiles Vocabulary:

 

The definition and note should be updated as they start with "A property..."
and "This property is ...". A definition and note should define and describe
the concept the property represents, not saying that "Property X represents
concept X". See e.g. guideline 4 in [Guidelines for writing definitions in
ontologies](https://philarchive.org/archive/SEPGFWv1)

 

E.g.

definition: profile identifier for use in APIs

note: Should be used when the Profile's URI cannot be used. For potential
use in content negotiation.

 

 

 

Nicholas Car

Senior Experimental Scientist

CSIRO Land & Water
41 Boggo Road, Dutton Park, QLD 4102, Australia

E nicholas.car@csiro.au <mailto:nicholas.car@csiro.au>  M 0477 560 177 P 07
3833 5632

 
Received on Wednesday, 27 February 2019 11:52:36 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 27 February 2019 11:52:36 UTC