Hi AMQP TC Members,
Unfortunately, the document approved [9] earlier by the TC as "AMQP Addressing Version 1.0" was not formatted for manageable publication in the OASIS process. We are providing this updated template so the specification can be reassembled in a publishable format. We regret the inconvenience, but remind the TC of the need to request a new starter document when a new Work Product is initiated.
- The attached starter document is formatted and named as "csd01". Many TCs find it most convenient to rename the file (typically as "wd01" for "working draft") while developing the content.
- Please note that References are now located in an appendix, rather than a main text section.
Per the request [1], please find the attached starter document for:
AMQP Addressing Version 1.0
WP-abbrev: addressing
When the TC first votes [6] to publish this Work Product in the OASIS Library, we expect it to be published at:
https://docs.oasis-open.org/amqp/addressing/v1.0/csd01/addressing-v1.0-csd01.html
The permanent "Latest version" URI will be:
https://docs.oasis-open.org/amqp/addressing/v1.0/addressing-v1.0.html
Please let me know if anything here fails to meet your expectations.
Further revisions to this Work Product should be maintained following procedures detailed in the OASIS TC Administration How-to Guide [2].
The attached starter document is formatted and named as "csd01" or "cnd01". Many TCs find it most convenient to rename the file (typically as "wd01" for "working draft") while developing the content.
Working drafts should be made available for TC approval and submission for publication by uploading the document(s) to the TC's Kavi document repository, or to the TC's Github or Subversion (SVN) repository, if used by your TC [3]. TCs are encouraged to use ZIP packaging when the draft releases contain multiple files (and directories).
For each working draft revision, you should:
1) increment the working draft revision (number) from 01 to 02, 03, 04 etc., as successive drafts are produced.
2) supply the relevant publication/release/upload date for each successive draft, using the prescribed date format: DD Month YYYY; the date needs to be updated at the top of the document and in the page footer.
3) provide suitable text for a document Abstract, updating the text to provide an accurate description of the subject matter, goals, scope, etc.
4) keep the Acknowledgments (Appendix B) and Revision History (Appendix C) up-to-date with each revision.
5) consult the OASIS Naming Directives document when creating new artifacts that may be part of the Work Product (e.g., image files, XML schemas), observing the rules for name characters in files and proposed directories, and for proposed URIs/namespaces [4].
6) examine the instructions for construction of XML Namespace Identifiers (namespace URIs) and Namespace Documents [5] if your specification declares one or more XML namespaces or other namespace-related identifiers for (e.g.,) link relations, named properties, functions, dialects, faults, actions, or any named message types. All such identifiers, if HTTP-scheme, must begin with: "https://docs.oasis-open.org/[tc-shortname]/ns/xxxx".
When the TC votes [6] to approve a working draft as a Committee Draft (CSD or CND), the Chair or other designated person must submit a "Committee Specification Draft Creation and Upload Request" accessible on the TC Administration Requests Page [7].
Upon receipt of this form, the TC Administrator will review and process the Work Product for official publication in the OASIS Library (https://docs.oasis-open.org/) as a Committee Draft, including addition of the requisite cover page metadata and other boilerplate information.
=========== References:
[1] https://tools.oasis-open.org/issues/browse/TCADMIN-3944
[2] Developing Committee Specifications and Notes
https://www-legacy.oasis-open.org/resources/tcadmin/developing-committee-specifications-and-notes
Starting a Working Draft
https://www-legacy.oasis-open.org/resources/tcadmin/starting-a-working-draft
[3] Github and SVN Version control, via Tools
https://tools.oasis-open.org/
[4] OASIS Naming Directives
https://docs.oasis-open.org/specGuidelines/ndr/namingDirectives.html
[5] OASIS Naming Directives - Namespace Identifiers and Namespace Documents
https://docs.oasis-open.org/specGuidelines/ndr/namingDirectives.html#xml-namespaces
[6] Approval of a WD as a CD (CSD or CND)
https://www-legacy.oasis-open.org/resources/tcadmin/approving-a-committee-specification-or-note-draft
https://www.oasis-open.org/policies-guidelines/tc-process#committeeDraft
[7] TC Administration Requests Page, see Committee Specification Draft Creation / Upload Request
https://www-legacy.oasis-open.org/resources/tc-admin-requests
[9] Ballot approving unpublishable document:Â
https://www.oasis-open.org/committees/ballot.php?id=3580
Best wishes,
Paul
--
Best wishes,
Paul
--
|