From cc68ca889eaf605d806494f74a1b970a88470965 Mon Sep 17 00:00:00 2001 From: Jim Amsden Date: Fri, 17 Sep 2021 13:26:51 -0400 Subject: [PATCH] Jra config psd01 (#540) * Add publishing metadata for config, and run ShapeChecker * Run all prettier checks, do not stop after first fail * Correct starting directory for prettier checks * Run the latest version of prettier (2.1.0) * Fix several links and accessibility issues * Fix prettier format for MarkDown file * More changes to README.md for linter!! * Stop running prettier on Markdown files * Remove excess spaces from Markdown files added by prettier * Update README to reflect very old change of name docs->specs * fixes #418 * Fix incorrect spacing in yaml * Fix HTML validation errors * Add a release link property to configurations * Update to ReSpec 2.1.20 * Merge in ShapeChecker changes from master * Fix bad merge of check-qm.sh * Selections type can no longer be inferred * Update to ReSpec 2.1.22 * Update to ReSpec 2.1.22 * Typos in activity shape * List required operations on selections resources * Add some notes to the ShapeChecker README * Updates to prepare for publishing PSD01 * Added machine readable files to additional artifacts Other minor updates. * Ran prettier * Added conformance clause to whitelist Configuration-Context header * Changed text on Acces-Control-Allow-Headers constraint * Had to run prettier again * Added ABNF for Configuration-Context * Removed reference to IETF RFC TBD * Added biblio reference to URI general syntax * Ran prettier one last time * Editorial updates requested by OASIS Added the part numbers back into the multi-part specification. * Ran prettier * Updated ReSpec And merged master into the branch Co-authored-by: ndjc --- specs/config/config-resources.html | 38 +++++++++++++++++---------- specs/config/config-vocab.html | 24 +++++++++-------- specs/config/oslc-config-mgt.html | 33 ++++++++++++----------- specs/config/versioned-resources.html | 36 ++++++++++++++----------- 4 files changed, 76 insertions(+), 55 deletions(-) diff --git a/specs/config/config-resources.html b/specs/config/config-resources.html index 766be40d..e030768e 100644 --- a/specs/config/config-resources.html +++ b/specs/config/config-resources.html @@ -6,9 +6,9 @@ name="description" content="This part of the OSLC Configuration Management Specification defines the representation and behavior of components and configurations of resources in those components (typically referred to as configurations of components, or just configurations)." /> - OSLC Configuration Management 1.0: Configuration Specification + OSLC Configuration Management Version 1.0. Part 3: Configuration Specification @@ -24,7 +24,7 @@ } var respecConfig = { shortName: "oslc-config-mgmt-cr", - citationLabel: "OSLC-ConfigMgmt-v1.0-cr", + citationLabel: "OSLC-Config-1.0-Part3", specStatus: status, revision: rev, conformanceLabelPrefix: "CONFIG-RES", @@ -76,22 +76,28 @@ // Other parts of multi-part spec additionalArtifacts: [ - { title: "OSLC Configuration Management 1.0: Overview", href: thisBase + "/oslc-config-mgt.html" }, { - title: "OSLC Configuration Management 1.0: Versioned Resources", + title: "OSLC Configuration Management Version 1.0. Part 1: Overview", + href: thisBase + "/oslc-config-mgt.html", + }, + { + title: "OSLC Configuration Management Version 1.0. Part 2: Versioned Resources", href: thisBase + "/versioned-resources.html", }, { - title: "OSLC Configuration Management 1.0: Configuration Specification (this document)", + title: "OSLC Configuration Management Version 1.0. Part 3: Configuration Specification (this document)", href: thisBase + "/config-resources.html", }, - { title: "OSLC Configuration Management 1.0: RDF Vocabulary", href: thisBase + "/config-vocab.html" }, { - title: "OSLC Configuration Management 1.0: Machine Readable Vocabulary Terms", + title: "OSLC Configuration Management Version 1.0. Part 4: RDF Vocabulary", + href: thisBase + "/config-vocab.html", + }, + { + title: "OSLC Configuration Management Version 1.0. Part 5: Machine Readable Vocabulary Terms", href: thisBase + "/config-vocab.ttl", }, { - title: "OSLC Configuration Management 1.0: Machine Readable Vocabulary Constraints", + title: "OSLC Configuration Management Version 1.0. Part 6: Machine Readable Vocabulary Constraints", href: thisBase + "/config-shapes.ttl", }, ], @@ -106,16 +112,20 @@ }, OSLCCore3: { title: "OSLC Core Version 3.0. Part 1: Overview", - href: "https://open-services.net/spec/core/latest", - authors: ["Jim Amsden", "S. Speicher"], - status: "Project Specification Draft", + href: "https://docs.oasis-open-projects.org/oslc-op/core/v3.0/oslc-core.html", + authors: ["Jim Amsden"], + publisher: "OASIS", + }, + TRS: { + title: "OSLC Tracked Resource Set Version 3.0. Part 1: Specification", + href: "https://docs.oasis-open-projects.org/oslc-op/trs/v3.0/tracked-resource-set.html", + authors: ["Steve Speicher", "Frank Budinsky", "Vivek Garg", "Nick Crossley"], publisher: "OASIS", }, OSLCQuery: { title: "OSLC Query Version 3.0", - href: "https://open-services.net/specifications/query/oslc-query.html", + href: "https://docs.oasis-open-projects.org/oslc-op/query/v3.0/oslc-query.html", authors: ["Jim Amsden", "S. Padgett", "S. Speicher", "David Honey"], - status: "Public Review Draft Project Specification", publisher: "OASIS", }, URI: { diff --git a/specs/config/config-vocab.html b/specs/config/config-vocab.html index 3171f506..b7fdfb89 100644 --- a/specs/config/config-vocab.html +++ b/specs/config/config-vocab.html @@ -3,9 +3,9 @@ - OSLC Configuration Management 1.0: RDF Vocabulary + OSLC Configuration Management Version 1.0. Part 4: RDF Vocabulary @@ -21,7 +21,7 @@ } var respecConfig = { shortName: "oslc-config-mgmt-vocab", - citationLabel: "OSLC-ConfigMgmt-1.0-vocab", + citationLabel: "OSLC-Config-1.0-Part4", specStatus: status, revision: rev, conformanceLabelPrefix: "CONFIG-VOCAB", @@ -74,25 +74,28 @@ // Other parts of multi-part spec additionalArtifacts: [ - { title: "OSLC Configuration Management 1.0: Overview", href: thisBase + "/oslc-config-mgt.html" }, { - title: "OSLC Configuration Management 1.0: Versioned Resources", + title: "OSLC Configuration Management Version 1.0. Part 1: Overview", + href: thisBase + "/oslc-config-mgt.html", + }, + { + title: "OSLC Configuration Management Version 1.0. Part 2: Versioned Resources", href: thisBase + "/versioned-resources.html", }, { - title: "OSLC Configuration Management 1.0: Configuration Specification", + title: "OSLC Configuration Management Version 1.0. Part 3: Configuration Specification", href: thisBase + "/config-resources.html", }, { - title: "OSLC Configuration Management 1.0: RDF Vocabulary (this document)", + title: "OSLC Configuration Management Version 1.0. Part 4: RDF Vocabulary (this document)", href: thisBase + "/config-vocab.html", }, { - title: "OSLC Configuration Management 1.0: Machine Readable Vocabulary Terms", + title: "OSLC Configuration Management Version 1.0. Part 5: Machine Readable Vocabulary Terms", href: thisBase + "/config-vocab.ttl", }, { - title: "OSLC Configuration Management 1.0: Machine Readable Vocabulary Constraints", + title: "OSLC Configuration Management Version 1.0. Part 6: Machine Readable Vocabulary Constraints", href: thisBase + "/config-shapes.ttl", }, ], @@ -100,9 +103,8 @@ localBiblio: { OSLCCore3: { title: "OSLC Core Version 3.0. Part 1: Overview", - href: "https://open-services.net/spec/core/latest", + href: "https://docs.oasis-open-projects.org/oslc-op/core/v3.0/oslc-core.html", authors: ["Jim Amsden", "S. Speicher"], - status: "Project Specification Draft", publisher: "OASIS", }, }, diff --git a/specs/config/oslc-config-mgt.html b/specs/config/oslc-config-mgt.html index eba30e66..78c2e586 100644 --- a/specs/config/oslc-config-mgt.html +++ b/specs/config/oslc-config-mgt.html @@ -6,9 +6,9 @@ name="description" content="OSLC Configuration Management defines an RDF vocabulary and a set of REST APIs for managing versions and configurations of linked data resources from multiple domains." /> - OSLC Configuration Management 1.0: Overview + OSLC Configuration Management Version 1.0. Part 1: Overview @@ -24,7 +24,7 @@ } var respecConfig = { shortName: "oslc-config-mgmt", - citationLabel: "OSLC-ConfigMgmt-v1.0-Overview", + citationLabel: "OSLC-Config-1.0-Part1", specStatus: status, revision: rev, conformanceLabelPrefix: "CONFIG-MGT", @@ -77,24 +77,27 @@ // Other parts of multi-part spec additionalArtifacts: [ { - title: "OSLC Configuration Management 1.0: Overview (this document)", + title: "OSLC Configuration Management Version 1.0. Part 1: Overview (this document)", href: thisBase + "/oslc-config-mgt.html", }, { - title: "OSLC Configuration Management 1.0: Versioned Resources", + title: "OSLC Configuration Management Version 1.0. Part 2: Versioned Resources", href: thisBase + "/versioned-resources.html", }, { - title: "OSLC Configuration Management 1.0: Configuration Specification", + title: "OSLC Configuration Management Version 1.0. Part 3: Configuration Specification", href: thisBase + "/config-resources.html", }, - { title: "OSLC Configuration Management 1.0: RDF Vocabulary", href: thisBase + "/config-vocab.html" }, { - title: "OSLC Configuration Management 1.0: Machine Readable Vocabulary Terms", + title: "OSLC Configuration Management Version 1.0. Part 4: RDF Vocabulary", + href: thisBase + "/config-vocab.html", + }, + { + title: "OSLC Configuration Management Version 1.0. Part 5: Machine Readable Vocabulary Terms", href: thisBase + "/config-vocab.ttl", }, { - title: "OSLC Configuration Management 1.0: Machine Readable Vocabulary Constraints", + title: "OSLC Configuration Management Version 1.0. Part 6: Machine Readable Vocabulary Constraints", href: thisBase + "/config-shapes.ttl", }, ], @@ -108,16 +111,16 @@ publisher: "http://open-services.net", }, OSLCCore3: { - title: "OSLC Core 3.0", - href: "https://docs.oasis-open.org/oslc-core/oslc-core/v3.0/oslc-core-v3.0-part1-overview.html", + title: "OSLC Core Version 3.0. Part 1: Overview", + href: "https://docs.oasis-open-projects.org/oslc-op/core/v3.0/oslc-core.html", authors: ["Jim Amsden"], publisher: "OASIS", }, TRS: { - title: "OSLC Tracked Resource Set", - href: "https://open-services.net/wiki/core/TrackedResourceSet-2.0/", - authors: ["Steve Speicher", "Frank Budinsky", "Vivek Garg"], - publisher: "http://open-services.net", + title: "OSLC Tracked Resource Set Version 3.0. Part 1: Specification", + href: "https://docs.oasis-open-projects.org/oslc-op/trs/v3.0/tracked-resource-set.html", + authors: ["Steve Speicher", "Frank Budinsky", "Vivek Garg", "Nick Crossley"], + publisher: "OASIS", }, ITSM: { title: "IT Service Management", diff --git a/specs/config/versioned-resources.html b/specs/config/versioned-resources.html index 8ca6b7e2..e60c05bf 100644 --- a/specs/config/versioned-resources.html +++ b/specs/config/versioned-resources.html @@ -6,9 +6,9 @@ name="description" content="This part of the OSLC Configuration Management Specification defines the representation and behavior of versioned resources." /> - OSLC Configuration Management 1.0: Versioned Resources + OSLC Configuration Management Version 1.0. Part 2: Versioned Resources @@ -24,7 +24,7 @@ } var respecConfig = { shortName: "oslc-config-mgmt-vr", - citationLabel: "OSLC-ConfigMgmt-v1.0-vr", + citationLabel: "OSLC-Config-1.0-Part2", specStatus: status, revision: rev, conformanceLabelPrefix: "CONFIG-VR", @@ -76,38 +76,44 @@ // Other parts of multi-part spec additionalArtifacts: [ - { title: "OSLC Configuration Management 1.0: Overview", href: thisBase + "/oslc-config-mgt.html" }, { - title: "OSLC Configuration Management 1.0: Versioned Resources (this document)", + title: "OSLC Configuration Management Version 1.0. Part 1: Overview", + href: thisBase + "/oslc-config-mgt.html", + }, + { + title: "OSLC Configuration Management Version 1.0. Part 2: Versioned Resources (this document)", href: thisBase + "/versioned-resources.html", }, { - title: "OSLC Configuration Management 1.0: Configuration Specification", + title: "OSLC Configuration Management Version 1.0. Part 3: Configuration Specification", href: thisBase + "/config-resources.html", }, - { title: "OSLC Configuration Management 1.0: RDF Vocabulary", href: thisBase + "/config-vocab.html" }, { - title: "OSLC Configuration Management 1.0: Machine Readable Vocabulary Terms", + title: "OSLC Configuration Management Version 1.0. Part 4: RDF Vocabulary", + href: thisBase + "/config-vocab.html", + }, + { + title: "OSLC Configuration Management Version 1.0. Part 5: Machine Readable Vocabulary Terms", href: thisBase + "/config-vocab.ttl", }, { - title: "OSLC Configuration Management 1.0: Machine Readable Vocabulary Constraints", + title: "OSLC Configuration Management Version 1.0. Part 6: Machine Readable Vocabulary Constraints", href: thisBase + "/config-shapes.ttl", }, ], localBiblio: { OSLCCore3: { - title: "OSLC Core 3.0", - href: "https://docs.oasis-open.org/oslc-core/oslc-core/v3.0/oslc-core-v3.0-part1-overview.html", + title: "OSLC Core Version 3.0. Part 1: Overview", + href: "https://docs.oasis-open-projects.org/oslc-op/core/v3.0/oslc-core.html", authors: ["Jim Amsden"], publisher: "OASIS", }, TRS: { - title: "OSLC Tracked Resource Set", - href: "https://open-services.net/wiki/core/TrackedResourceSet-2.0/", - authors: ["Steve Speicher", "Frank Budinsky", "Vivek Garg"], - publisher: "https://open-services.net", + title: "OSLC Tracked Resource Set Version 3.0. Part 1: Specification", + href: "https://docs.oasis-open-projects.org/oslc-op/trs/v3.0/tracked-resource-set.html", + authors: ["Steve Speicher", "Frank Budinsky", "Vivek Garg", "Nick Crossley"], + publisher: "OASIS", }, }, };