TC Admin public review feedback on AMQP v1.0 csprd02

[Chet Ensign <chet.ensign@oasis-open.org>]

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