4.9.2 Mandatory Outline

Return to Submission Format

All submissions SHALL use the following structure, based on the OMG specification template [TEMPL].

Section 0 of the Submission SHALL provide all non-normative supporting material relevant to the evaluation of the proposed specification, including:

• The full name of the Submission
• A complete list of all OMG Members making the Submission, with a named contact individual for each OMG Member
• The acronym proposed for the specification, such as UML or CORBA
• The name and OMG document number of the RFP to which the Submission responds
• The OMG document number of the main Submission document
• An overview or guide to the material in the Submission
• A statement of proof of concept, as described in Section 4.8 Proof of Concept
• A detailed rationale explaining why the proposal does not satisfy any general requirement stated in Section 5 General Requirements on Proposals
• A discussion of each Issue to Be Discussed identified in Section 6 Specific Requirements on Proposals
• An explanation of how the proposal satisfies the specific requirements and, where applicable, requests stated in Section 6 Specific Requirements on Proposals

If adopting the Submission requires changes to already-adopted OMG specifications, Section 0 SHALL include a list of those changes in a clearly labeled subsection. The list SHALL identify exactly which versions of which OMG specifications SHALL be amended. The list SHALL include the precise wording changes that SHALL be made to each affected specification.

Section 1 and subsequent sections of the Submission SHALL contain the normative specification that the Submitters propose for adoption by OMG, including:

• The scope of the proposed specification
• The overall design rationale
• Conformance criteria for implementations of the proposed specification, clearly stating the features that all conformant implementations SHALL support and any features that implementations MAY support but are not mandatory
• A list of the normative references used by the proposed specification
• A list of terms used in the proposed specification, with their definitions
• A list of any special symbols used in the proposed specification, together with their significance
• The proposed specification itself

OMG deletes Section 0 from any specification that OMG adopts and publishes. Therefore, Section 0 of the Submission SHALL contain no normative material other than instructions to change existing specifications. The Finalisation Task Force, responsible for finalising the specification, must ensure that those instructions are implemented before deleting Section 0.

Any non-normative material outside Section 0 SHALL be explicitly identified.

The main Submission document and any models or other machine-interpretable files accompanying the Submission SHALL be listed in an inventory file conforming to the inventory template [INVENT].

The Submission SHALL include a copyright waiver in a form acceptable to OMG. One acceptable form is:

Each of the entities listed above: (i) grants to the Object Management Group, Inc. (OMG) a nonexclusive, royalty-free, paid up, worldwide license to copy and distribute this document and to modify this document and distribute copies of the modified version, and (ii) grants to each member of the OMG a nonexclusive, royalty-free, paid up, worldwide license to make up to fifty (50) copies of this document for internal review purposes only and not for distribution, and (iii) has agreed that no person shall be deemed to have infringed the copyright in the included material of any such copyright holder by reason of having used any OMG specification that may be based hereon or having conformed any computer software to such specification.

Other forms of copyright waiver MAY be used only if approved in advance by OMG legal counsel.