Skip to content

Commit

Permalink
Jra trsv3.0 psd01 2 (#530)
Browse files Browse the repository at this point in the history
Co-authored-by: Andrew Berezovskyi <andriib@kth.se>
  • Loading branch information
Jim Amsden and berezovskyi authored Aug 12, 2021
1 parent 579f58b commit 69090fa
Show file tree
Hide file tree
Showing 5 changed files with 274 additions and 19 deletions.
237 changes: 237 additions & 0 deletions specs/trs/tracked-resource-set-shapes.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,237 @@
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="utf-8" />
<title>OSLC Tracked Resource Set Version 3.0. Part 3: Constraints</title>
<meta
name="description"
content="Specifies the standard constraints on the OSLC Tracked Resource Set vocabulary terms."
/>
<script
src="https://cdn.jsdelivr.net/gh/oasis-tcs/tab-respec@v2.1.28/builds/respec-oasis-common.js"
async
class="remove"
></script>
<script class="remove">
var filePath = "/tracked-resource-set-vocab.html";
var status = "PSD";
var wdBase = "https://oslc-op.github.io/oslc-specs/specs/trs";
var oasisBase = "https://docs.oasis-open-projects.org/oslc-op/trs/v3.0";
var rev = "01";
var thisBase = wdBase;
if (status != "WD") {
thisBase = oasisBase + "/" + status.toLowerCase() + rev;
}
var respecConfig = {
shortName: "oslc-trs",
citationLabel: "OSLC-TRS-v3.0",
specStatus: status,
revision: rev,
thisVersion: thisBase + filePath,
publishDate: "2021-08-26T12:00Z",
maxTocLevel: 3,
noConformanceTable: 1,
license: "cc-by-4",
additionalLicenses: [
{
licenseName: "Apache License 2.0",
licenseURI: "https://www.apache.org/licenses/LICENSE-2.0",
},
],

editors: [
{
name: "Nick Crossley",
mailto: "nick_crossley@us.ibm.com",
company: "IBM",
companyURL: "http://www.ibm.com",
},
],

chairs: [
{
name: "Jim Amsden",
mailto: "jamsden@us.ibm.com",
company: "IBM",
companyURL: "https://www.ibm.com/",
},
{
name: "Andrii Berezovskyi",
mailto: "andriib@kth.se",
company: "KTH",
companyURL: "https://www.kth.se/",
},
],

// Namespaces defined by this spec
namespaces: [
{ href: "http://open-services.net/ns/core/trs#", prefix: "trs" },
{ href: "http://open-services.net/ns/core/trspatch#", prefix: "trspatch" },
],

// Other parts of multi-part spec
additionalArtifacts: [
{ title: "OSLC TRS Version 3.0. Part 1: Specification", href: "tracked-resource-set.html" },
{
title: "OSLC TRS Version 3.0. Part 2: Vocabulary",
href: "tracked-resource-set-vocab.html",
},
{
title: "OSLC TRS Version 3.0. Part 3: Constraints (this document)",
href: "tracked-resource-set-shapes.html",
},
{ title: "OSLC TRS Version 3.0: Part 4: Machine-readable RDF Vocabulary", href: "trs-vocab.ttl" },
{ title: "OSLC TRS Version 3.0: Part 5: Machine-readable Resource Shapes", href: "trs-shapes.ttl" },
],

localBiblio: {
VOCAB: {
title: "OSLC TRS Version 3.0: Part 3: Machine-readable vocabulary",
href: "http://open-services.net/ns/trs",
authors: ["Nick Crossley", "Frank Budinsky"],
status: "Finalization",
publisher: "http://open-services.net",
},
},
};
</script>
</head>
<body>
<section id="abstract">
<p>This specification defines standard constraints on the vocabulary for Tracked Resource Sets.</p>
</section>
<section id="toc"></section>
<section id="sotd"></section>
<section id="intro" class="informative">
<h2>Introduction</h2>
<p>This specification defines standard constraints on the vocabulary for Tracked Resource Sets.</p>
<p>
RDF vocabularies define the terms and resources for a domain of interest, in this case, OSLC Tracked Resource
Sets. These vocabularies are often specified in an open manner, without providing information such as property
domain and range assertions, cardinalities, etc. This helps keep the vocabulary applicable for a wide range of
uses and furthering integration with other vocabularies.
</p>

<p>
However, it is often desirable to closed down a vocabulary with specific constraints to facilitate using the
vocabulary for a specific purpose. This document specifies the constraints for using the OSLC Tracked Resource
Set vocabulary in OSLC. Different sets of constraints may be applied to a vocabulary in order to tailor its use,
without overly constraining the vocabulary for other usages.
</p>

<p>
These constraints apply to the core vocabulary defined in
<a href="tracked-resource-set-vocab.html">OSLC Tracked Resource Set Version 3.0. Part 2: Vocabulary</a>.
</p>
<p>
Note that this document is informative; the normative document for the vocabulary is the machine-readable source
in [[VOCAB]].
</p>
<section id="conventions" class="informative" />
<section id="references">
<h3>References</h3>
</section>
</section>

<section id="resourceConstraints">
<h2>Resource Constraints</h2>
<p>
This section specifies the constraints for Tracked Resource Set resources. The resource properties are not
limited to the ones defined in this specification, TRS Servers may provide additional properties. It is
recommended that any additional properties exist in their own unique namespace and not use the namespaces
defined in these specifications.
</p>

<section id="resource">
<h3>Resource: TrackedResourceSetShape</h3>
<p></p>

<div
title="Shapes for Tracked Resource Set"
data-include="./trs-shapes.ttl#TrackedResourceSetShape"
data-oninclude="shapeToSpec"
data-include-sync="true"
data-include-replace="true"
data-include-format="html"
></div>
</section>

<section id="resource">
<h3>Resource: BaseShape</h3>
<p></p>

<div
title="Shapes for Tracked Resource Set"
data-include="./trs-shapes.ttl#BaseShape"
data-oninclude="shapeToSpec"
data-include-sync="true"
data-include-replace="true"
data-include-format="html"
></div>
</section>

<section id="resource">
<h3>Resource: ChangeLogShape</h3>
<p></p>

<div
title="Shapes for Tracked Resource Set"
data-include="./trs-shapes.ttl#ChangeLogShape"
data-oninclude="shapeToSpec"
data-include-sync="true"
data-include-replace="true"
data-include-format="html"
></div>
</section>

<section id="resource">
<h3>Resource: CreationEventShape</h3>
<p></p>

<div
title="Shapes for Tracked Resource Set"
data-include="./trs-shapes.ttl#CreationEventShape"
data-oninclude="shapeToSpec"
data-include-sync="true"
data-include-replace="true"
data-include-format="html"
></div>
</section>

<section id="resource">
<h3>Resource: ModificationEventShape</h3>
<p></p>

<div
title="Shapes for Tracked Resource Set"
data-include="./trs-shapes.ttl#ModificationEventShape"
data-oninclude="shapeToSpec"
data-include-sync="true"
data-include-replace="true"
data-include-format="html"
></div>
</section>

<section id="resource">
<h3>Resource: DeletionEventShape</h3>
<p></p>

<div
title="Shapes for Tracked Resource Set"
data-include="./trs-shapes.ttl#DeletionEventShape"
data-oninclude="shapeToSpec"
data-include-sync="true"
data-include-replace="true"
data-include-format="html"
></div>
</section>
</section>
<section id="conformance">
<h2>Conformance</h2>
<p class="conformance">
OSLC TRS Servers MUST use the vocabulary terms defined here where required, and with the meanings defined here.
Servers MAY augment this vocabulary with additional terms.
</p>
</section>
</body>
</html>
16 changes: 10 additions & 6 deletions specs/trs/tracked-resource-set-vocab.html
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,15 @@
<head>
<meta charset="utf-8" />
<title>OSLC Tracked Resource Set Version 3.0. Part 2: Vocabulary</title>
<meta name="description" content="Specifies the OSLC Tracked Resource Set vocabulary terms." />
<script
src="https://cdn.jsdelivr.net/gh/oasis-tcs/tab-respec@v2.1.26/builds/respec-oasis-common.js"
src="https://cdn.jsdelivr.net/gh/oasis-tcs/tab-respec@v2.1.28/builds/respec-oasis-common.js"
async
class="remove"
></script>
<script class="remove">
var filePath = "/tracked-resource-set-vocab.html";
var status = "WD";
var status = "PSD";
var wdBase = "https://oslc-op.github.io/oslc-specs/specs/trs";
var oasisBase = "https://docs.oasis-open-projects.org/oslc-op/trs/v3.0";
var rev = "01";
Expand All @@ -24,8 +25,7 @@
specStatus: status,
revision: rev,
thisVersion: thisBase + filePath,
previousPublishDate: "2014-06-11",
previousMaturity: "WD",
publishDate: "2021-08-26T12:00Z",
maxTocLevel: 3,
noConformanceTable: 1,
license: "cc-by-4",
Expand Down Expand Up @@ -73,8 +73,12 @@
title: "OSLC TRS Version 3.0. Part 2: Vocabulary (this document)",
href: "tracked-resource-set-vocab.html",
},
{ title: "OSLC TRS Version 3.0: Part 3: Machine-readable RDF Vocabulary", href: "trs-vocab.ttl" },
{ title: "OSLC TRS Version 3.0: Part 4: Machine-readable Resource Shapes", href: "trs-shapes.ttl" },
{
title: "OSLC TRS Version 3.0. Part 3: Constraints ",
href: "tracked-resource-set-shapes.html",
},
{ title: "OSLC TRS Version 3.0: Part 4: Machine-readable RDF Vocabulary", href: "trs-vocab.ttl" },
{ title: "OSLC TRS Version 3.0: Part 5: Machine-readable Resource Shapes", href: "trs-shapes.ttl" },
],

localBiblio: {
Expand Down
32 changes: 23 additions & 9 deletions specs/trs/tracked-resource-set.html
Original file line number Diff line number Diff line change
Expand Up @@ -2,20 +2,22 @@
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="utf-8" />
<title>OSLC Tracked Resource Set Specification</title>
<title>OSLC Tracked Resource Set Version 3.0. Part 1: Specification</title>
<script
src="https://cdn.jsdelivr.net/gh/oasis-tcs/tab-respec@v2.1.26/builds/respec-oasis-common.js"
src="https://cdn.jsdelivr.net/gh/oasis-tcs/tab-respec@v2.1.28/builds/respec-oasis-common.js"
async
class="remove"
></script>
<!-- <script src="http://127.0.0.1:9000/respec-oasis-common.js" async class="remove"></script> -->

<script class="remove">
var filePath = "/tracked-resource-set.html";
var status = "WD";
var status = "PSD";
var wdBase = "https://oslc-op.github.io/oslc-specs/specs/trs";
var oasisBase = "https://docs.oasis-open-projects.org/oslc-op/trs/v3.0";
var rev = "01";
var thisBase = wdBase;
if (status != "WD") {
if (status != "PSD") {
thisBase = oasisBase + "/" + status.toLowerCase() + rev;
}
var respecConfig = {
Expand All @@ -24,8 +26,7 @@
specStatus: status,
revision: rev,
thisVersion: thisBase + filePath,
previousPublishDate: "2014-06-11",
previousMaturity: "WD",
publishDate: "2021-08-26T12:00Z",
maxTocLevel: 3,
license: "cc-by-4",
additionalLicenses: [
Expand Down Expand Up @@ -68,11 +69,24 @@
// Other parts of multi-part spec
additionalArtifacts: [
{ title: "OSLC TRS Version 3.0. Part 1: Specification (this document)", href: "tracked-resource-set.html" },
{ title: "OSLC TRS Version 3.0. Part 2: Vocabulary", href: "tracked-resource-set-vocab.html" },
{ title: "OSLC TRS Version 3.0: Part 3: Machine-readable RDF Vocabulary", href: "trs-vocab.ttl" },
{ title: "OSLC TRS Version 3.0: Part 4: Machine-readable Resource Shapes", href: "trs-shapes.ttl" },
{
title: "OSLC TRS Version 3.0. Part 2: Vocabulary",
href: "tracked-resource-set-vocab.html",
},
{
title: "OSLC TRS Version 3.0. Part 3: Constraints ",
href: "tracked-resource-set-shapes.html",
},
{ title: "OSLC TRS Version 3.0: Part 4: Machine-readable RDF Vocabulary", href: "trs-vocab.ttl" },
{ title: "OSLC TRS Version 3.0: Part 5: Machine-readable Resource Shapes", href: "trs-shapes.ttl" },
],

relatedWork: [
{
title: "OSLC Tracked Resource Set Guidance",
href: "guidance.html",
},
],
localBiblio: {
OSLCCore2: {
title: "OSLC Core 2.0",
Expand Down
4 changes: 2 additions & 2 deletions specs/trs/trs-shapes.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -21,9 +21,9 @@
dcterms:publisher <https://open-services.net/about/> ;
dcterms:source <https://github.com/oslc-op/oslc-specs/blob/master/specs/trs/trs-shapes.ttl> ;
dcterms:isPartOf <https://oslc-op.github.io/oslc-specs/specs/trs/tracked-resource-set.html> ;
dcterms:hasVersion "WD" ;
dcterms:hasVersion "PSD" ;
dcterms:license <http://www.apache.org/licenses/LICENSE-2.0> ;
#dcterms:issued "2021-xx-xx"^^<http://www.w3.org/2001/XMLSchema#date> ;
dcterms:issued "2021-08-26"^^<http://www.w3.org/2001/XMLSchema#date> ;
dcterms:dateCopyrighted "2012-2021" .

:TrackedResourceSetShape
Expand Down
4 changes: 2 additions & 2 deletions specs/trs/trs-vocab.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -19,9 +19,9 @@ trs:
dcterms:description "The OSLC Core Tracked Resource Set vocabulary defines terms used in describing Tracked Resource Sets." ;
dcterms:source <https://github.com/oslc-op/oslc-specs/blob/master/specs/trs/trs-vocab.ttl> ;
dcterms:isPartOf <https://oslc-op.github.io/oslc-specs/specs/trs/tracked-resource-set.html> ;
dcterms:hasVersion "WD" ;
dcterms:hasVersion "PSD" ;
dcterms:license <http://www.apache.org/licenses/LICENSE-2.0> ;
#dcterms:issued "2021-xx-xx"^^<http://www.w3.org/2001/XMLSchema#date> ;
dcterms:issued "2021-08-26"^^<http://www.w3.org/2001/XMLSchema#date> ;
dcterms:dateCopyrighted "2012-2021" ;
vann:preferredNamespacePrefix "trs" .

Expand Down

0 comments on commit 69090fa

Please sign in to comment.