New Issue: WS-AT: conceptual nature of protocol diagrams needs tobe underlined

[Alastair Green <alastair.green@choreology.com>]

Issue name -- WS-AT: conceptual nature of protocol diagrams needs to be 
underlined

PLEASE DO NOT REPLY TO THIS EMAIL OR START A DISCUSSISON THREAD UNTIL 
THE ISSUE IS ASSIGNED A NUMBER.

The issues coordinators will notify the list when that has occurred.

Target document and draft:

Protocol:  WS-AT

Artifact:  spec

Draft:

WS-AT CD 0.1 uploaded

Link to the document referenced:

http://www.oasis-open.org/apps/org/workgroup/ws-tx/download.php/17325/wstx-wsat-1.1-spec-cd-01.pdf

Section and PDF line number:

l. 191, Section 4.3, "Two-Phase Commit Protocol", diagram.
Coordinator and Participant View State Tables, l. 503 onwards.


Issue type:

Editorial


Related issues:


Issue Description:

The state tables show (in model and in detail) a substantially different 
view form the abstract protocol diagrams. Need to state that fact.


Issue Details:

The conceptual character of the protocol diagrams is not clear enough. 
The predominance or override of the state tables needs to be stated 
explicitly. The diagrams do not have the same states or state 
transitions as the state tables. They are good simplifications which 
situate readers at a first pass, but no more than that. Similarly the 
text that accompanies them.


Proposed Resolution:

Replace the sentence on l. 191 with the following:

"The diagram and text in this section give a simplified, conceptual 
non-normative overview of the way in which the 2PC protocol works. The 
state tables in Section 10, "State Tables" are detailed and normative."

[This resolution requires refinement if Replay is retained, as the only 
statement about what Replay means and when it might be sent is in this 
section.]