TAB Report to Board 31 July 2014. Completed Work 2014 “Keyword Guidelines for OASIS Specifications...
-
Upload
matthew-riley -
Category
Documents
-
view
213 -
download
1
Transcript of TAB Report to Board 31 July 2014. Completed Work 2014 “Keyword Guidelines for OASIS Specifications...
![Page 1: TAB Report to Board 31 July 2014. Completed Work 2014 “Keyword Guidelines for OASIS Specifications and Standards” Systematic review of all 1 st PRs +](https://reader035.fdocuments.in/reader035/viewer/2022062806/5697bf9b1a28abf838c92a3a/html5/thumbnails/1.jpg)
TAB Report to Board
31 July 2014
![Page 2: TAB Report to Board 31 July 2014. Completed Work 2014 “Keyword Guidelines for OASIS Specifications and Standards” Systematic review of all 1 st PRs +](https://reader035.fdocuments.in/reader035/viewer/2022062806/5697bf9b1a28abf838c92a3a/html5/thumbnails/2.jpg)
Completed Work 2014 • “Keyword Guidelines for OASIS
Specifications and Standards”
• Systematic review of all 1st PRs + documentation to guide reviewers
• [comment?]-tagged HTML files for PR
• TAB public page and resources
• Open Standards Cup final selections
![Page 3: TAB Report to Board 31 July 2014. Completed Work 2014 “Keyword Guidelines for OASIS Specifications and Standards” Systematic review of all 1 st PRs +](https://reader035.fdocuments.in/reader035/viewer/2022062806/5697bf9b1a28abf838c92a3a/html5/thumbnails/3.jpg)
Public Reviews
• At Board request, TAB made PRs a 2013/2014 priority
- 4 WS-BRSP Profiles - BDX Location
- 3 Bindings for OBIX - CAMP v1.1
- 1 Encodings for OBIX - DSS Extension
- Trust Elevation Framework - 12 KMIP CSDs/CNDs
- MQTT and NIST Cybersecurity Framework
- OBIX v1.1
- 5 PKCS CSDs - SAML Conformance Clause
- TOSCA v1.0 - TGF v2.0
- 2 XACML Profiles
![Page 4: TAB Report to Board 31 July 2014. Completed Work 2014 “Keyword Guidelines for OASIS Specifications and Standards” Systematic review of all 1 st PRs +](https://reader035.fdocuments.in/reader035/viewer/2022062806/5697bf9b1a28abf838c92a3a/html5/thumbnails/4.jpg)
Public Reviews
• > 700 comments issued on 39 public reviews
• Review methodology • TAB only reviewed 1st PR
• Reivewed per TAB’s PR Checklist
• Comments tracked in JIRA & Excel exports made available
• Applied categorization at high-level
![Page 5: TAB Report to Board 31 July 2014. Completed Work 2014 “Keyword Guidelines for OASIS Specifications and Standards” Systematic review of all 1 st PRs +](https://reader035.fdocuments.in/reader035/viewer/2022062806/5697bf9b1a28abf838c92a3a/html5/thumbnails/5.jpg)
Issue categories• Normative: e.g normative vs. non-normative, use
of formal keywords
• Reference: e.g. incorrect, missing
• Style: e.g. formatting errors
• Technical: e.g. terminology, completeness
• Structure: e.g. misuse of sections & parts
• Conformance: e.g. referencing of normative content, relation to implementations, etc.
• Process: e.g. consistency with TC Process rules
![Page 6: TAB Report to Board 31 July 2014. Completed Work 2014 “Keyword Guidelines for OASIS Specifications and Standards” Systematic review of all 1 st PRs +](https://reader035.fdocuments.in/reader035/viewer/2022062806/5697bf9b1a28abf838c92a3a/html5/thumbnails/6.jpg)
Sample commentsConformance: “The conformance clauses <snip> are too vague for
implementers to attempt conformance with the specification. For example, 2.3, leaves many terms undefined and/or unclear.”
“The "table list" in the conformance clause has only one element...So if "an implementation may choose to implement and conform to one or more", then "Each of them is optional to implement" is just not true: this single list element is mandatory to support.”
![Page 7: TAB Report to Board 31 July 2014. Completed Work 2014 “Keyword Guidelines for OASIS Specifications and Standards” Systematic review of all 1 st PRs +](https://reader035.fdocuments.in/reader035/viewer/2022062806/5697bf9b1a28abf838c92a3a/html5/thumbnails/7.jpg)
Sample commentsReferences:
“Normative Reference currently reads <snip>. The correct citation is <snip> as reported by http://www.w3.org/2002/01/tr-automation/tr-biblio-ui”
“RFC 2630 is listed in non-normative references but is cited as a normative document in the definitions. Also RFC 2630 has been obsoleted by RFC3369, RFC3370, and RFC3369 has been obsoleted by RFC3852.”
![Page 8: TAB Report to Board 31 July 2014. Completed Work 2014 “Keyword Guidelines for OASIS Specifications and Standards” Systematic review of all 1 st PRs +](https://reader035.fdocuments.in/reader035/viewer/2022062806/5697bf9b1a28abf838c92a3a/html5/thumbnails/8.jpg)
Sample commentsTechnical:
“In the Process flow of Use Case 5, some apparent actors are used (see upper case words POLICY_AUTHOR, ATTRIBUTE_PROVIDER ) that have not been defined in the Actors section.”
“The paragraph under 17 Security Considerations reads <snip>. These are the only two uses of "principal" in the document. Both are requirements (MUST) and yet are undefined in the document.”
![Page 9: TAB Report to Board 31 July 2014. Completed Work 2014 “Keyword Guidelines for OASIS Specifications and Standards” Systematic review of all 1 st PRs +](https://reader035.fdocuments.in/reader035/viewer/2022062806/5697bf9b1a28abf838c92a3a/html5/thumbnails/9.jpg)
Analyzing the comments
![Page 10: TAB Report to Board 31 July 2014. Completed Work 2014 “Keyword Guidelines for OASIS Specifications and Standards” Systematic review of all 1 st PRs +](https://reader035.fdocuments.in/reader035/viewer/2022062806/5697bf9b1a28abf838c92a3a/html5/thumbnails/10.jpg)
Analyzing the comments
![Page 11: TAB Report to Board 31 July 2014. Completed Work 2014 “Keyword Guidelines for OASIS Specifications and Standards” Systematic review of all 1 st PRs +](https://reader035.fdocuments.in/reader035/viewer/2022062806/5697bf9b1a28abf838c92a3a/html5/thumbnails/11.jpg)
Next steps• Careful not to infer too much into data
• Caveats: differing levels of review from one to next, consolidation of comments, etc.
• Drill into the top categories – style, reference, normative – to see if there is more to learn
• Identify where best practice advice to editors might be of value
![Page 12: TAB Report to Board 31 July 2014. Completed Work 2014 “Keyword Guidelines for OASIS Specifications and Standards” Systematic review of all 1 st PRs +](https://reader035.fdocuments.in/reader035/viewer/2022062806/5697bf9b1a28abf838c92a3a/html5/thumbnails/12.jpg)
Work in progress
Conformance Clauses Guidelines upgrade
Specification Editors Best Practices Guidelines
Public review comment handling procedures and templates
![Page 13: TAB Report to Board 31 July 2014. Completed Work 2014 “Keyword Guidelines for OASIS Specifications and Standards” Systematic review of all 1 st PRs +](https://reader035.fdocuments.in/reader035/viewer/2022062806/5697bf9b1a28abf838c92a3a/html5/thumbnails/13.jpg)
Board Process Advisory / Consultation Work
?
Public review comment handling procedures and templates
![Page 14: TAB Report to Board 31 July 2014. Completed Work 2014 “Keyword Guidelines for OASIS Specifications and Standards” Systematic review of all 1 st PRs +](https://reader035.fdocuments.in/reader035/viewer/2022062806/5697bf9b1a28abf838c92a3a/html5/thumbnails/14.jpg)
New Work
• Charter Guidelines
• …