TC Admin comments on PR04

Insert link to email

TC Administration provides the following comments for the public
review of the above Committee Specification Drafts. Comments are
divided between fixes required to conform to the TC Process
requirements and general observations. The public review was announced
on 04 October 2011.
(http://lists.oasis-open.org/archives/tc-announce/201110/msg00003.html)

Required:

• We noted no issues that require fixing.

General:
The following items were observed in the content. These do not require
correcting but we provide them for your consideration.

1. Normative and non-normative references to other OASIS documents do
not use OASIS recommended format:

Normative references:

• SOA-RM OASIS Standard, OASIS Reference Model for Service Oriented
  Architecture 1.0, October 2006 http://docs.oasis-open.org/soa-rm/v1.0/

• WS-Calendar OASIS Committee Specification 1.0, WS-Calendar, July
  2011, http://docs.oasis-open.org/ws-calendar/ws-calendar-spec/v1.0/cs01/ws-calendar-spec-v1.0-cs01.pdf

Non-normative:

• TeMIX Transactive Energy Market Information Exchange [TeMIX] an
  approved Note of the EMIX TC. Ed Cazalet et al.
  http://www.oasis-open.org/committees/download.php/37954/TeMIX-20100523.pdf

• WS-Calendar Note OASIS Committee Note Public Review Draft,
  WS-Calendar Conceptual Overview,
  http://docs.oasis-open.org/ws-calendar/ws-calendar/v1.0/CD01/WS-Calendar-Conceptual-Overview-CD01.pdf

The citation construction that we use for OASIS documents is:

[CITATION-LABEL]
Work Product title (italicized). Approval date (DD Month YYYY). Stage
Identifier and Revision Number (e.g., Committee Specification Draft
01). Principal URI (version-specific URI, e.g., including the filename
component with stage and revision: /somespec-v1.0-csd01.html).

For current specifications, we include these in the cite-as section of
the cover pages.

So, for SOA-RM (which is an older spec and does not include a
'cite-as' entry), the format would be:

[SOA-RM]
<ital>Reference Model for Service Oriented Architecture 1.0</ital>. 12
October 2006. OASIS Standard.
http://docs.oasis-open.org/soa-rm/v1.0/soa-rm.html

For WS-Calendar:

[WS-Calendar]
<ital>WS-Calendar Version 1.0</ital>. 30 July 2011. OASIS Committee
Specification 01.
http://docs.oasisopen.org/ws-calendar/ws-calendar-spec/v1.0/cs01/ws-calendar-spec-v1.0-cs01.html.

For TeMIX:

[TeMIX-Information-Model]
<ital>Transactional Energy Market Information Exchange (TeMIX); An
Information Model for Energy Transactions in the Smart Grid</ital>. 23
May 2010. Committee White Paper.
http://www.oasis-open.org/committees/download.php/37954/TeMIX-20100523.pdf

For the WS-Calendar note, the citation form would be:

[WS-Calendar-Overview]
<ital>Conceptual Overview of WS-Calendar CD01</ital>. 15 September
2010. Committee Note Public Review Draft.
http://docs.oasis-open.org/ws-calendar/ws-calendar/v1.0/CD01/WS-Calendar-Conceptual-Overview-CD01.pdf

2. There is a non-normative reference to a document with a broken URI:
NIEM NIEM Technical Architecture Committee (NTAC), National
Information Exchange Model Naming and Design Rules v1.3, October 2008,
http://www.niem.gov/pdf/NIEM-NDR-1-3.pdf

3. The namespace document referenced in line 159 (PDF) no longer
exists. The text is: "... of this document at
http://docs.oasis-open.org/ns/emix/2011/ will change accordingly. "

4. LIne 269 (PDF) refers to an appendix which no longer exists, at
least in its earlier location or form: The text is: "... [WS-Calendar]
semantics is provided in Appendix E."

Please let us know if you have any questions on any of these.