[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: CMIS work product review
The following issues have been idientified in the submitted work products and must be corrected before they can be uploaded to docs.oasis-open.org : 1. Creation of a master document (Content Management Interoperability Services Version 1.0) that contains all common information and references the 3 separate components. Note all changes in all documents should be accepted before publishing. ---- Domain Model: 1. Title should be as follows: Content Management Interoperability Services Version 1.0 Part 1 - Domain Model 2. Status: Committee Draft 01 (or whatever number is appropriate; should be consecutive) 3. Specification URIs This Version: Please see URI Generator for assistance in determining (http://www.oasis-open.org/committees/uri-block-generator.php ) Also, one of the 3 formats must be declared as authoritative (noted by the word 'Authoritative' in parens following the specific URL) Previous Version: Should be 'N/A' Latest Version: Should be version-agnostic URIs 4. OASIS Technical Committee Please spell out the full name of the committee; also hypertext link should point to TC public home page 5. Related work: This is meant for related OASIS work only 6. Namespaces: This should be a hypertext link; also need namespace document (see templates at http://docs.oasis-open.org/templates) 7. Abstract: Remove references to files in svn. Any/all references must be to fixed/ static versions either in docs.oasis-open.org or Kavi. 8. Status: Hypertext links behind physical URLs do not match the named locations. 9. Notices: Copyright should be 2009 "CMIS" should be added after "OASIS" where it's noted [insert specific trademarked names and abbreviations here] No other modifications are allowed to the Notices section. (You might want to place CMIS logo usage information in an appendix) 10. Footer: document identifier should match filename without extension Date is improperly formatted Page # of # should be right-justified 11. References Still contains OASIS boilerplate templates 12. Section 4 Schema Says placeholder. Recommend moving schema to appendix; note separate schema file will take precedence over any schema incorporated into the specification file. 13. Conformance Section Needs to actually be numbered. 14. Acknowledgements: Only TC Members can be listed in the specification. Note that Associate members are not entitled to have their company name listed. Associate members can most easily be identified by looking at the roster and seeing whether their company is a hyperlink or just plain text. Associates will not be hyperlinked (Ektron, EsoCE- NET, Greenbytes, FatWire) ----- Restful AtomPub Binding 1. Title should be as follows: Content Management Interoperability Services Version 1.0 Part 3 - Restful AtomPub Binding 2. Status: Committee Draft 01 (or whatever number is appropriate; should be consecutive) 3. Specification URIs This Version: Please see URI Generator for assistance in determining (http://www.oasis-open.org/committees/uri-block-generator.php ) Also, one of the 3 formats must be declared as authoritative (noted by the word 'Authoritative' in parens following the specific URL) Previous Version: Should be 'N/A' Latest Version: Should be version-agnostic URIs 4. OASIS Technical Committee Hypertext link should point to TC public home page 5. Namespaces: This should be a hypertext link; also need namespace document (see templates at http://docs.oasis-open.org/templates) 6. Status: Hypertext links behind physical URLs do not match the named locations. 7. Notices: Copyright should be 2009 "CMIS" should be added after "OASIS" where it's noted [insert specific trademarked names and abbreviations here] 8. Footer: document identifier should match filename without extension Date is improperly formatted 9. References Need URL for CMISDM 10. Conformance Section Needs to actually be numbered. 11. Acknowledgements: Only TC Members can be listed in the specification. Note that Associate members are not entitled to have their company name listed. Associate members can most easily be identified by looking at the roster and seeing whether their company is a hyperlink or just plain text. Associates will not be hyperlinked (Ektron, EsoCE- NET, Greenbytes, FatWire) ---- Web Services Binding 1. Title should be as follows: Content Management Interoperability Services Version 1.0 Part 2 - Web Services Binding 2. Status: Committee Draft 01 (or whatever number is appropriate; should be consecutive) 3. Specification URIs This Version: Please see URI Generator for assistance in determining (http://www.oasis-open.org/committees/uri-block-generator.php ) Also, one of the 3 formats must be declared as authoritative (noted by the word 'Authoritative' in parens following the specific URL) Previous Version: Should be 'N/A' Latest Version: Should be version-agnostic URIs 4. OASIS Technical Committee Hypertext link should point to TC public home page 5. Namespaces: This should be a hypertext link; also need namespace document (see templates at http://docs.oasis-open.org/templates) 6. Status: Hypertext links behind physical URLs do not match the named locations. 7. Notices: Copyright should be 2009 "CMIS" should be added after "OASIS" where it's noted [insert specific trademarked names and abbreviations here] 8. Footer: document identifier should match filename without extension 9. References Need URL for CMISSCHEMA Remove boilerplate citation notice 10. Conformance Section Needs to actually be numbered. 11. Acknowledgements: Only TC Members can be listed in the specification. Note that Associate members are not entitled to have their company name listed. Associate members can most easily be identified by looking at the roster and seeing whether their company is a hyperlink or just plain text. Associates will not be hyperlinked (Ektron, EsoCE- NET, Greenbytes, FatWire) Regards, Mary Mary P McRae Director, Standards Development Technical Committee Administrator OASIS: Advancing open standards for the information society email: mary.mcrae@oasis-open.org web: www.oasis-open.org twitter: fiberartisan #oasisopen phone: 1.603.232.9090 Standards are like parachutes: they work best when they're open.
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]