Hi all, I had a careful read through the RM spec. Could somebody please fix the vocabulary respect errors? The .ttl files are not being loaded. The rest of my comments are here.
Specification:
- Additional artifacts references vocabulary 2.0 whereas the document itself says the version is 2.1 (https://htmlpreview.github.io/?https://raw.githubusercontent.com/oasis-tcs/oslc-domains/master/rm/requirements-management-vocab.html
)
- Abstract: <missing!>
- Status: RF on Limited Terms hyperlink should be
https://www.oasis-open.org/policies-guidelines/ipr#s10.2.3
- Copyright notice should be 2018
- Sec 1 2nd sentence: supports key RESTful web services interface[s] for … (add [s])
- Sec 1 3rd sentence: OSLC [RM] takes an open…. (remove [RM])
- Sec 1 4th sentence: … were created by the OSLC Domains TC.
- Recommend we move 1.4 (conventions and keywords) up to 1.2 so it applies to the rest of the document
- I don’t think we need to include the IPR Policy section since the same text already appears in the Status section.
- Should we have a Motivation section? See
https://tools.oasis-open.org/version-control/browse/wsvn/oslc-core/trunk/specs/config/oslc-config-mgt.html#motivation for an example
- Terminology section should be marked Non-normative and maybe use same formatting as in
https://tools.oasis-open.org/version-control/browse/wsvn/oslc-core/trunk/specs/config/oslc-config-mgt.html#terminology ?
- Sec 2.4 resource formats: Just a thought: Should we maybe have a reference to the exact document in which the normative requirements for core are listed? Specifically
https://tools.oasis-open.org/version-control/svn/oslc-core/trunk/specs/oslc-core.html#resourceOperations where in 4.4.1 we say the service MUST accept text/turtle and application/ld+json. That’s pretty important!
- Sec 2.5 authentication: In addition to … , OSLC [RM] servers SHOULD support… (not [CM])
- Sec 2.6 – Same RM not CM
- Sec 2.8.3 – Same RM not CM
- Sec 3 – should be 2.1 not 2.0
- Sec 4.1 – “outwith”? With all due respect to Ian, I’d recommend “beyond” as more standard English (2 instances)
- Sec 4.3 – results misspelled “resutls”
Vocabulary:
- Use a more current date under the title?
- Additional artifacts should list Vocabulary as (this document)
- Same notes re status, copyright notice
- Move 1.3 up to 1.1?
- Sec 1.3 references oslc_qm which I believe is not used in the rm spec? (Couldn’t find it in the vocab or shapes docs)
- Sec 3.1 and 3.2:
It is strongly recommended that any additional properties be defined in XML namespaces distinct from those defined by OSLC in these specifications. I believe the core spec says you MUST use non-OSLC namespaces.
- Missing the actual vocabulary! 3 respec errors:
Error including URI=./requirements-management-vocab.ttl: error (NetworkError: Failed to execute 'send' on 'XMLHttpRequest': Failed to load 'https://raw.githubusercontent.com/oasis-tcs/oslc-domains/master/rm/requirements-management-vocab.ttl'.)
Error including URI=./requirements-management-shapes.ttl#Requirement: error (NetworkError: Failed to execute 'send' on 'XMLHttpRequest': Failed to load 'https://raw.githubusercontent.com/oasis-tcs/oslc-domains/master/rm/requirements-management-shapes.ttl'.)
Error including URI=./requirements-management-shapes.ttl#RequirementCollection: error (NetworkError: Failed to execute 'send' on 'XMLHttpRequest': Failed to load 'https://raw.githubusercontent.com/oasis-tcs/oslc-domains/master/rm/requirements-management-shapes.ttl'.)
This is when I use
https://htmlpreview.github.io/?https://raw.githubusercontent.com/oasis-tcs/oslc-domains/master/rm/requirements-management-vocab.html
To read the vocab spec. Should I use a different URL instead?
Regards, Martin
|
Dr. Martin Sarabura
Technical Fellow, Office of Research & Architecture
+1 519.502.4819
msarabura@ptc.com
|