NEW Issue: Various Editorial 2

[William Cox <wtcox@CoxSoftwareArchitects.com>]

PLEASE DO NOT REPLY TO THIS EMAIL OR START A DISCUSSION THREAD UNTIL THE ISSUE IS ASSIGNED A NUMBER.

The issues coordinators will notify the list when that has occurred.

Protocol: bqos / rating / sla / others

Artifact: spec

Type: editorial

Title: Various Editorial 2

Description:

These editorial corrections are referenced to http://www.oasis-open.org/committees/download.php/32576/BusinessQualityOfService-v1.0-spec-wd04.pdf  but apply to all three specifications; line numbers are in BQOS. 

(1) First two lines of Status on title page should be deleted.

(2) Rewrite Introduction. Suggested text:
"This documnent is the specification for Business Quality of Service for End-to-End Resource planning, an XML vocabuly by which a business application may communicate selected characteristics of the service it provides."  The suggested text applies to BQOS; similar text will be suggested in other issues for the rating and sla.

(3) A longer introduction describing EERP in general, and relating the three specifications, would be desirable in all three documents.

(4) Delete "All text is normative unless otherwise indicated." This is in square brackets in the specification template at http://docs.oasis-open.org/templates/OASISSpecificationTemplateV3.2.dot and should not appear in the final document.

(5) Section 1.1, namespaces, should be after Non-Normative references at the start of Section 2.

(6) In BQOS line 66-67 change "standard" to "specification" and change "model, and bQoS should" to "model. bQoS should".

(7) Generally for section headings in all of the specification (see in BQOS lines 150, 205, 311)  make the section heading the same as the element type, e.g. line 150 in BQOS should read "BQoSPrice" with no spaces.

Related issues:
Number not assigned: Various Editorial 1

Proposed Resolution:

Correct as indicated.


bill cox
--
William Cox
Email: wtcox@CoxSoftwareArchitects.com
Web: http://www.CoxSoftwareArchitects.com
+1 862 485 3696 mobile
+1 908 277 3460 fax