[OASIS Issue Tracker] Commented: (AMQP-43) Review comments from Ram Jeyaraman

[OASIS Issues Tracker <workgroup_mailer@lists.oasis-open.org>]

    [ http://tools.oasis-open.org/issues/browse/AMQP-43?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=29212#action_29212 ] 

Rob Godfrey commented on AMQP-43:
---------------------------------

- Add Working Draft number. 
** The status and number of the document is set through the build process.  Official drafts released by the editors will have version numbers.  There is no requirement for a change to the document source here

- Suggest changing "Thu 11/24/2011" to "Thursday 11/24/11". Avoid using the short form of the day. 
** The date string is generated as part of the build process.  On non Windows platforms this does not include the day of the week, but instead reads in the following style "19 January 2012".  This will be the style used for official builds of the document.  No change is therefore required.

- Suggest changing "OASIS AMQP TC" to "OASIS AMQP Technical Committee", in all occurrences. 
** Looking at a number of other committee's documents the use of either the full term or the abbreviation is common.  However for clarity I propose making this change.

- Suggest changing "Additional Artifcats" to "Additional Artifacts". 
** Agreed - simple spelling error.

- Suggest changing Part 1: Types - "the AMQP type" to "AMQP type". Similarly, in the following bullet items pertaining to Part 2, Part 3, Part 4, Part 5. 
** Agreed.

- Footer: Add a space between copyright symbol and "OASIS". 
** Agreed


Copyright:
- "Please see http://www.oasisopen.org/who/trademark.php (http://www.oasis-open.org/who/trademark.php) for above guidance". The hyperlink is repeated. Need to check with OASIS staff and correct this.
** Agreed

Section 3.4: Suggest adding periods after end of each bullet item. 
** Agreed

Part 4 Transactions: In all figures, the letter 'F' in the term "TRANSFER" uses a different font, and a result appears smaller than the surrounding characters. Suggest fixing this.
** I believe this issue must be an artefact of the viewer you are using to look at the document / the printout you have.  The font is consistent in all diagram text and none of the editors observed the effect you are describing using their PDF viewers.


> Review comments from Ram Jeyaraman
> ----------------------------------
>
>                 Key: AMQP-43
>                 URL: http://tools.oasis-open.org/issues/browse/AMQP-43
>             Project: OASIS Advanced Message Queuing Protocol (AMQP) TC
>          Issue Type: Improvement
>            Reporter: Rob Godfrey
>            Assignee: Rob Godfrey
>
> Front Page:
> -          Add Working Draft number.
> -          Suggest changing "Thu 11/24/2011" to "Thursday 11/24/11". Avoid using the short form of the day.
> -          Suggest changing "OASIS AMQP TC" to "OASIS AMQP Technical Committee", in all occurrences.
> -          Suggest changing "Additional Artifcats" to "Additional Artifacts".
> -          Suggest changing Part 1: Types - "the AMQP type" to "AMQP type". Similarly, in the following bullet items pertaining to Part 2, Part 3, Part 4, Part 5.
> -          Footer: Add a space between copyright symbol and "OASIS".
> :Copyright:
> -          "Please see http://www.oasisopen.org/who/trademark.php (http://www.oasis-open.org/who/trademark.php) for above guidance". The hyperlink is repeated. Need to check with OASIS staff and correct this.
> Section 3.4: Suggest adding periods after end of each bullet item.
> Part 4 Transactions: In all figures, the letter 'F' in the term "TRANSFER" uses a different font, and a result appears smaller than the surrounding characters. Suggest fixing this.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://tools.oasis-open.org/issues/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira