Re: [ws-tx] Issue 057 - WS-AT: conceptual nature of protocol diagrams needsto be underlined

[Ian Robinson <ian_robinson@uk.ibm.com>]

The diagrams are already prefixed with the text "The diagram below
illustrates the protocol abstractly:"
This seems sufficient - I'm not sure there is a need to add anything
further.

Regards,
Ian


                                                                           
             "Ram Jeyaraman"                                               
             <Ram.Jeyaraman@mi                                             
             crosoft.com>                                               To 
                                       <ws-tx@lists.oasis-open.org>        
             06/04/2006 18:55                                           cc 
                                                                           
                                                                   Subject 
                                       [ws-tx] Issue 057 - WS-AT:          
                                       conceptual nature of protocol       
                                       diagrams needs to be underlined     
                                                                           
                                                                           
                                                                           
                                                                           
                                                                           
                                                                           





This is identified as WS-TX issue 057.

Please ensure follow-ups have a subject line starting "Issue 057 -
WS-AT: conceptual nature of protocol diagrams needs to be underlined".

-----Original Message-----
From: Alastair Green [mailto:alastair.green@choreology.com]
Sent: Wednesday, April 05, 2006 5:19 PM
To: ws-tx@lists.oasis-open.org
Subject: [ws-tx] New Issue: WS-AT: conceptual nature of protocol
diagrams needs to be underlined

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/ws
tx-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.]