[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [oslc-core-comment] TC Admin comments on OSLC Core V3.0 csprd02
Chet,
I can address these issues today if you would like and send you a new Zip. Or should we wait and address these as updates for publishing the committee specification?
Jim Amsden, Senior Technical Staff Member
OSLC and Linked Lifecycle Data
919-525-6575
From: Chet Ensign <chet.ensign@oasis-open.org>
To: oslc-core-comment@lists.oasis-open.org
Cc: Paul Knight <paul.knight@oasis-open.org>
Date: 02/17/2017 01:16 PM
Subject: [oslc-core-comment] TC Admin comments on OSLC Core V3.0 csprd02
Sent by: <oslc-core-comment@lists.oasis-open.org >
Members of the OSLC Core TC,
In preparing your content for public review, we encountered the following items that we bring to your attention.
1) Neither csprd01 nor csprd02 labelled which version of the spec is authoritative. In future published versions, the work needs to indicate which version is authoritative (e.g. the HTML).
2) Under Additional artifacts, the link to part 7 is broken. Has .html.html for file extension on the link (the displayed URL is ok).
3) For the Citation format label, we'd prefer "v3.0" instead of just 3.0.
4) In Part 1, sect 4.5 - the link to Common Vocabulary Terms is broken with .html.html on link
5) In Part 1, sect 4.12 - the link to Common Vocabulary Terms, Errors is broken with .html.html on link
6) In Part 5, 1.2.1 Normative references, the displayed url for [OSLCCore3] is to the docs.oasis-open.orgfile but the underlying link is to svn. That link fails. The correct link seems to be used in all the other docs.
7) In Part 7, Citation format, the first link (the csprd02 link) is broken. Underlying link has .html.html as the file extension
8) At top of Notices section, the copyright line uses the copyright symbol twice. Should be "Copyright <symbol> OASIS Open 2017"
9) In the Notices section, the links under Policy (first paragraph) and OASIS and https://www.oasis-open.org/policies-guidelines/trademark (last paragraph) should use 'https'. They do in the current csprd draft because we fixed them during publication. They should be fixed in the source.
10) In part 1, section 4.10, there is a reference to 'Linked Data Platform Paging 1.0.' Since it is referenced from the spec, it should be added to the Normative References section.
11) In part 5, Section 4.3 - reference to "Media Types" (http://www.iana.org/assignments/media-types/ ) should be added to the References section, either Normative or Non-Normative.
12) In part 5, Section 6.1 - the link in table to PURL media-type resource is broken. Also, this looks like another reference that needs to be added the Normative or Non-Normative references.
13) In part 6, under Editors, none of Arthur Ryman's identifying information given. It needs to be published just as for others.
14) In Section 5.2, under oslc:isMemberProperty Property, the hyperlink under [LDP] and "Linked Data Platform Containers" seems to have no valid target. Clicking on them does nothing in my browser.
15) In Appendix A, there is a typo - first occurrence of "Resource" in Appendix A text lacks the "r".
16) In part 7, 5.3.3 - hyperlinked phrase " similar clause on reuse" (hyerlinked to http://www.w3.org/TR/ldp/#ldprs-gen-reusevocabsuchas ) - we would prefer to show the hyperlink visibly, like " similar clause on reuse at http://www.w3.org/TR/ldp/#ldprs-gen-reusevocabsuchas ".
Let us know if you have any questions.
Best regards,
--
/chet
----------------
Chet Ensign
Director of Standards Development and TC Administration
OASIS: Advancing open standards for the information society
http://www.oasis-open.org
Primary: +1 973-996-2298
Mobile: +1 201-341-1393
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]