OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

amqp message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Disposition of public review comments on OASIS AMQP Version 1.0 CSPRD02


The AMQP TC carefully evaluated the public review comments (see email below) on OASIS AMQP 1.0 CSPRD02 and has addressed them as follows:

·       Disposition of comment #1: https://tools.oasis-open.org/issues/browse/AMQP-74

·       Disposition of comment #2: https://tools.oasis-open.org/issues/browse/AMQP-75  

 

-----Original Message-----
From: amqp@lists.oasis-open.org [mailto:amqp@lists.oasis-open.org] On Behalf Of Chet Ensign
Sent: Wednesday, June 20, 2012 11:23 AM
To: amqp@lists.oasis-open.org
Cc: TCA
Subject: [amqp] TC Admin public review feedback on AMQP v1.0 csprd02

 

In preparing the AMQP Committee Spec draft 02 for release, we noted some minor issues that we bring here to your attention:

 

1. There are many terminology definitions with elements along the right margin where the links point to non-existent anchors and thus the links fail.

 

For example, in part 3: Messaging, beginning in section 3.2.1, with the definitions of the field names, there are terms along the right margin which link to type and transport definitions. "types.xml" is referenced 22 times (all broken) and "transport.xml" 6 times.

 

Similarly, in Part 2: Transport there are about 33 broken links. In Part 4: Transactions, there are two and in in Part 5: Security, there are 7 bad links.

 

We used the Firefox add-on "Pinger" to check the links.

 

2. Some minor elements in the Front Matter are not perfect:

 

- The URI for the link to the TC does not end with "/" (i.e. .../amqp/). We end all location URIs with the slash as a simple web best practice.

 

- In Citation format, word "OASIS" missing from usual "OASIS Committee Specification Draft ..."

 

- On the title for Messaging, there is a extra blank space between the 3 and the : (i.e. Part 3 : Mess…)

 

- The links in the Notices section don't match currently-used URIs for the "Policy" link on the second line and the "trademark" link on the bottom line (although the links do redirect properly). The links we use are http://www.oasis-open.org/policies-guidelines/ipr and http://www.oasis-open.org/policies-guidelines/trademark.

 

Impact:

For item 1, under current TC Process rules, you will need to run another round of public review if you change the specification documents. We expect that rule to ease substantially after the OASIS Board F2F at the end of July when simple fixes like this can be done without incurring penalty.

 

For item 2, as these are cover page changes (typically considered created by TC Administration) you can fix those without triggering another round of review.

 

Please let me know if you have any questions.

 

 

/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

 

 

 

 

 

 

---------------------------------------------------------------------

To unsubscribe, e-mail: amqp-unsubscribe@lists.oasis-open.org

For additional commands, e-mail: amqp-help@lists.oasis-open.org

 

 

 

 



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]