[oslc-op] Errata in OSLC Quality Management Specification Version 2.1 OASIS Standard 19 January 2022
Chet,
We discovered a copy/paste mistake in one of the above specification’s additional components files. File quality-management-shapes.ttl contains:
:TestResultShape
a oslc:ResourceShape ;
oslc:describes oslc_qm:TestResult ;
oslc:property [ a oslc:Property ;
oslc:allowedValue "com.ibm.rqm.execution.common.state.failed" , "com.ibm.rqm.execution.common.state.inconclusive" , "com.ibm.rqm.execution.common.state.passed" , "com.ibm.rqm.execution.common.state.deferred" , "com.ibm.rqm.execution.common.state.incomplete" , "com.ibm.rqm.execution.common.state.blocked" , "com.ibm.rqm.execution.common.state.part_blocked" , "com.ibm.rqm.execution.common.state.perm_failed" , "com.ibm.rqm.execution.common.state.error" ;
oslc:hidden false ;
oslc:isMemberProperty false ;
oslc:name "status" ;
oslc:occurs oslc:Zero-or-one ;
oslc:propertyDefinition oslc_qm:status ;
oslc:readOnly false ;
oslc:valueType xsd:string ;
dcterms:description "Used to indicate the state of the Test Result based on values defined by the service provider. Most often a read-only property." ;
dcterms:title "Status" , "Status"@en
] ;
Ths should be:
:TestResultShape
a oslc:ResourceShape ;
oslc:describes oslc_qm:TestResult ;
oslc:property [ a oslc:Property ;
oslc:hidden false ;
oslc:isMemberProperty false ;
oslc:name "status" ;
oslc:occurs oslc:Zero-or-one ;
oslc:propertyDefinition oslc_qm:status ;
oslc:readOnly false ;
oslc:valueType xsd:string ;
dcterms:description "Used to indicate the state of the Test Result based on values defined by the service provider. Most often a read-only property." ;
dcterms:title "Status" , "Status"@en
] ;
The oslc:allowedValues contained content copied from the IBM implementation that should have been removed. This was editing oversight that does not result in any changes to any of the other published specification parts.
Note that the Turtle file, quality-management-shapes.ttl is the normative content which the normative sections in the specification generated from this file. The oslc:allowedValues is not included in any of these ReSpec rendered documents.
How should we go about following an errata process to update quality-management-shapes.ttl and remove the oslc:allowedValues?
|
Hi all,Here are my initial comments, subject to Chet's review:Since the files for this OASIS Standard have not yet been installed and announced, I think we can handle this without issuing Errata.I would suggest something like a "README" text file included in the publication directory, to note that line 240 of this file has been corrected, and now differs from the file approved by the membership of OASIS during the "Call for Consent". (i.e., the file at https://docs.oasis-open-projects.org/oslc-op/qm/v2.1/ps01/quality-management-shapes.ttl)We could also include similar language in the announcement of the publication of the OS.Best regards,PaulOn Thu, Feb 24, 2022 at 2:44 PM Jim Amsden <jamsden@...> wrote:Chet,
We discovered a copy/paste mistake in one of the above specification’s additional components files. File quality-management-shapes.ttl contains:
:TestResultShape
a oslc:ResourceShape ;
oslc:describes oslc_qm:TestResult ;
oslc:property [ a oslc:Property ;
oslc:allowedValue "com.ibm.rqm.execution.common.state.failed" , "com.ibm.rqm.execution.common.state.inconclusive" , "com.ibm.rqm.execution.common.state.passed" , "com.ibm.rqm.execution.common.state.deferred" , "com.ibm.rqm.execution.common.state.incomplete" , "com.ibm.rqm.execution.common.state.blocked" , "com.ibm.rqm.execution.common.state.part_blocked" , "com.ibm.rqm.execution.common.state.perm_failed" , "com.ibm.rqm.execution.common.state.error" ;
oslc:hidden false ;
oslc:isMemberProperty false ;
oslc:name "status" ;
oslc:occurs oslc:Zero-or-one ;
oslc:propertyDefinition oslc_qm:status ;
oslc:readOnly false ;
oslc:valueType xsd:string ;
dcterms:description "Used to indicate the state of the Test Result based on values defined by the service provider. Most often a read-only property." ;
dcterms:title "Status" , "Status"@en
] ;
Ths should be:
:TestResultShape
a oslc:ResourceShape ;
oslc:describes oslc_qm:TestResult ;
oslc:property [ a oslc:Property ;
oslc:hidden false ;
oslc:isMemberProperty false ;
oslc:name "status" ;
oslc:occurs oslc:Zero-or-one ;
oslc:propertyDefinition oslc_qm:status ;
oslc:readOnly false ;
oslc:valueType xsd:string ;
dcterms:description "Used to indicate the state of the Test Result based on values defined by the service provider. Most often a read-only property." ;
dcterms:title "Status" , "Status"@en
] ;
The oslc:allowedValues contained content copied from the IBM implementation that should have been removed. This was editing oversight that does not result in any changes to any of the other published specification parts.
Note that the Turtle file, quality-management-shapes.ttl is the normative content which the normative sections in the specification generated from this file. The oslc:allowedValues is not included in any of these ReSpec rendered documents.
How should we go about following an errata process to update quality-management-shapes.ttl and remove the oslc:allowedValues?
--
Paul Knight
Document Process
OASIS Open
+1 781 425 5073
paul.knight@...
www.oasis-open.org
Chet EnsignChief Technical Community Steward OASIS Open |
|
Sounds good to me. We can go with that./chetOn Thu, Feb 24, 2022 at 4:07 PM Paul Knight <paul.knight@...> wrote:Hi all,Here are my initial comments, subject to Chet's review:Since the files for this OASIS Standard have not yet been installed and announced, I think we can handle this without issuing Errata.I would suggest something like a "README" text file included in the publication directory, to note that line 240 of this file has been corrected, and now differs from the file approved by the membership of OASIS during the "Call for Consent". (i.e., the file at https://docs.oasis-open-projects.org/oslc-op/qm/v2.1/ps01/quality-management-shapes.ttl)We could also include similar language in the announcement of the publication of the OS.Best regards,PaulOn Thu, Feb 24, 2022 at 2:44 PM Jim Amsden <jamsden@...> wrote:Chet,
We discovered a copy/paste mistake in one of the above specification’s additional components files. File quality-management-shapes.ttl contains:
:TestResultShape
a oslc:ResourceShape ;
oslc:describes oslc_qm:TestResult ;
oslc:property [ a oslc:Property ;
oslc:allowedValue "com.ibm.rqm.execution.common.state.failed" , "com.ibm.rqm.execution.common.state.inconclusive" , "com.ibm.rqm.execution.common.state.passed" , "com.ibm.rqm.execution.common.state.deferred" , "com.ibm.rqm.execution.common.state.incomplete" , "com.ibm.rqm.execution.common.state.blocked" , "com.ibm.rqm.execution.common.state.part_blocked" , "com.ibm.rqm.execution.common.state.perm_failed" , "com.ibm.rqm.execution.common.state.error" ;
oslc:hidden false ;
oslc:isMemberProperty false ;
oslc:name "status" ;
oslc:occurs oslc:Zero-or-one ;
oslc:propertyDefinition oslc_qm:status ;
oslc:readOnly false ;
oslc:valueType xsd:string ;
dcterms:description "Used to indicate the state of the Test Result based on values defined by the service provider. Most often a read-only property." ;
dcterms:title "Status" , "Status"@en
] ;
Ths should be:
:TestResultShape
a oslc:ResourceShape ;
oslc:describes oslc_qm:TestResult ;
oslc:property [ a oslc:Property ;
oslc:hidden false ;
oslc:isMemberProperty false ;
oslc:name "status" ;
oslc:occurs oslc:Zero-or-one ;
oslc:propertyDefinition oslc_qm:status ;
oslc:readOnly false ;
oslc:valueType xsd:string ;
dcterms:description "Used to indicate the state of the Test Result based on values defined by the service provider. Most often a read-only property." ;
dcterms:title "Status" , "Status"@en
] ;
The oslc:allowedValues contained content copied from the IBM implementation that should have been removed. This was editing oversight that does not result in any changes to any of the other published specification parts.
Note that the Turtle file, quality-management-shapes.ttl is the normative content which the normative sections in the specification generated from this file. The oslc:allowedValues is not included in any of these ReSpec rendered documents.
How should we go about following an errata process to update quality-management-shapes.ttl and remove the oslc:allowedValues?
--
Paul Knight
Document Process
OASIS Open
+1 781 425 5073
paul.knight@...
www.oasis-open.org --
Chet Ensign
Chief Technical Community Steward
OASIS Open
+1 201-341-1393
chet.ensign@...
www.oasis-open.org
|