oslc-core message
[Date Prev]
| [Thread Prev]
| [Thread Next]
| [Date Next]
--
[Date Index]
| [Thread Index]
| [List Home]
Subject: Position of resource shapes in resource preview spec (was: Version Control Commit by sspeiche)
- From: Martin P Pain <martinpain@uk.ibm.com>
- To: oslc-core@lists.oasis-open.org, Steve K Speicher <sspeiche@us.ibm.com>
- Date: Thu, 21 Aug 2014 11:35:47 +0100
Quick feedback:
I suggest the resource shapes definition
goes further down - probably at the end, just before the appendices. When
reading through it in order, the definition of the properties & classes
may make sense at that point (between the non-normative intro & the
normative stuff) as they give an overview of the data in use, but I think
the resource shapes don't make sense until you see them in use (i.e. in
context) in the normative text. (So a link from the normative text to the
appropriate shapes further down the document would make sense).
Having said that the properties &
classes may make sense that early, in specs where there are more terms
than this one then I would suggest that the properties & classes move
down to the bottom as well. So perhaps, for pre-emptive consistency, we
should move it all to the bottom.
That way the "progressive disclosure"
goes: (1) general description, (2) normative description, (3) things that
are used/referenced by those descriptions (vocabulary specifics).
Especially as the vocab terms are part
of a vocab, separate from the spec, in a sense they are external references.
(Although we might in that section define how they are used by this spec
- but I expect that would be a summary of what's in the normative description
anyway.)
[I know this is a work-in-progress -
this feedback is my contribution to that progress :) ]
Martin
<oslc-core@lists.oasis-open.org> wrote on 20/08/2014
03:05:56:
> From: workgroup_mailer@lists.oasis-open.org
> To: oslc-core@lists.oasis-open.org
> Date: 20/08/2014 03:05
> Subject: [oslc-core] Version Control Commit by
sspeiche
> Sent by: <oslc-core@lists.oasis-open.org>
>
> Author: sspeiche
> Date: 2014-08-20 02:05:56 +0000 (Wed, 20 Aug 2014)
> New Revision: 15
> Web View: https://tools.oasis-open.org/version-control/browse/wsvn/
> oslc-core/?rev=15&sc=1
>
> Modified:
> specs/resource-preview.html
> Log:
> Added sections for separate terms and shapes, also proposed doc
> structure changes.
>
>
> ---------------------------------------------------------------------
> 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
[Date Prev]
| [Thread Prev]
| [Thread Next]
| [Date Next]
--
[Date Index]
| [Thread Index]
| [List Home]