Re: [oslc-core] "Common properties" resource shape vs simple table (Re: [oslc-core] Version Control Commit by jamsden)

["Jim Amsden" <jamsden@us.ibm.com>]

Martin,
I'm still struggling with getting ReSpec
to work in my file system and after checkin - https seems to be causing
difficulties, the shapes aren't displaying properly. Working on that now.

Regarding common properties, I found
a good solution which I intended to summarize in a note indicating core-vocab.html
is ready for TC review - but the shape rendering problems held up that
note.

The solution is that ResourceShape does
not require an oslc:describes property - meaning you can create a ResourceShape
that doesn't constrain anything. This is intended to support shapes that
could be applied to anything as needed - exactly what we want with common
properties. This seems like a reasonable compromise that:
1. doesn't define any root OSLC resource
2. doesn't require any of the properties
- they're all optional
3. uses a uniform way of displaying
properties in the specs using ReSpec
4. provides the common properties in
a machine readable Turtle file like any other shape properties.

Unfortunately, ReSpec doesn't handle
the situation where oslc:describes is either missing, or refers to a class
that isn't defined in any vocabulary. The use of oslc:describes oslc:Any
is just a work around to get the shape to render until this bug is fixed.
Then that can be removed.

I also had to use oslc:Any on the Preson
ResourceShape. foaf:Person didn't work because the namespace URI for FOAF
doesn't appear to Accept text/turtle.  I haven't figured out how to
fix this yet.




Jim Amsden, Senior Technical Staff Member
OSLC and Linked Lifecycle Data
919-525-6575




From:      
 "Martin P Pain"
<martinpain@uk.ibm.com>
To:      
 oslc-core@lists.oasis-open.org
Date:      
 12/22/2015 03:51 AM
Subject:    
   [oslc-core]
"Common properties" resource shape vs simple table (Re: [oslc-core]
Version Control Commit by jamsden)
Sent by:    
   <oslc-core@lists.oasis-open.org>

---

Two pieces of feedback/questions for this
check-in:
 
1. When we talked about the common properties
in the meeting on 10th Dec, I believe the conclusion was to "use a
human-written table rather than using the tool to communicate the "common"
properties", as noted in the minutes.  (Although we didn't note
that it was an agreement/conclusion). That is, listing them similar to
the description of JSON properties in dialogs/previews. As it's not a shape
(it's not constraints), it's a list of properties. There's no point using
the spec2shape tool if it's not a good fit, and your difficulties are suggesting
that it's not a good fit, and others have suggested shapes semantically
not accurate for common properties. I know you got disconnected Jim, so
weren't included in the last part of the discussion.
Can any one else confirm or deny my recollection
of last meeting?
 
2. Also, is there a precedent for using `oslc:Any`
as the object of an `oslc:describes` property? I can't actually find the
definition of oslc:Any.
 
----- Original message -----
From: workgroup_mailer@lists.oasis-open.org
Sent by: <oslc-core@lists.oasis-open.org>
To: oslc-core@lists.oasis-open.org
Cc:
Subject: [oslc-core] Version Control Commit by jamsden
Date: Mon, Dec 21, 2015 10:06 PM
  
Author: jamsden
Date: 2015-12-21 22:05:59 +0000 (Mon, 21 Dec 2015)
New Revision: 310
Web View: https://tools.oasis-open.org/version-control/browse/wsvn/oslc-core/trunk/specs/?rev=310&sc=1

Modified:
   trunk/specs/core-vocab.html
   trunk/specs/shapes/CommonProperties-shape.ttl
Log:
Got core-vocab.html to be able to process CommonProperties-shape.ttl using
ReSpec by making sure oslc:describes for each resource shape refers to
a defined vocabulary resource. Can't reference foaf:Person yet. Issue OSLCCORE-57
raised.

---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail.  Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
 
 
Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number
741598. 
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6
3AU

--------------------------------------------------------------------- To
unsubscribe from this mail list, you must leave the OASIS TC that generates
this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php