TC Admin public review comments on xmile-v1.0-csprd01

[Chet Ensign <chet.ensign@oasis-open.org>]

Members of the XMILE TC,

TC Administration provides the following comments for the public review of the Committee Specification Draft. The public review was announced on 9/11/14, see https://lists.oasis-open.org/archives/members/201409/msg00007.html

- Section 1.2 Normative References 

** remove the boilerplate text “[Reference]             [Full reference citation]” 

- Section 1.3 Non-Normative References 

** all the text in this section is boilerplate from the starter document. If you have no non-normative references in the spec, just remove the entire section. If there are non-normative references, delete the boilerplate and add the references to the section. 

- Check your numbered section references. For example, the last sentence of the intro to section 2, just before Section 2.1, reads “as detailed in section mentions 1.11.3.” However no 1.11.3 exists. Note similar in Section 4.7.2 - ref to 1.7.3 is bad. Also section refs from asterisks in 5.2 are wrong. Also ref from 5.3 to 1.7

- Section 2.1 

** the last paragraph has a typo - "even through" instead of "even though" 

- Section 7, conformance clauses 

** This needs much more meat on it. The reason the conformance clauses are important is that they spell out the tests that determine whether an application conforms to the spec or not - crucial since only conforming implementations get the IPR protections. 

I’m sure the TAB will provide in depth advice on this topic. For now, see the guidelines document at http://docs.oasis-open.org/templates/TCHandbook/ConformanceGuidelines.html 

- Appendix B. Revision History - please use this section to document the changes made from one draft to another. 

--

/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 

Check your work using the Support Request Submission Checklist at http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html 

TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin

Follow OASIS on:
LinkedIn:    http://linkd.in/OASISopen
Twitter:        http://twitter.com/OASISopen
Facebook:  http://facebook.com/oasis.open