[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [ws-tx] Issue 057 - WS-AT: conceptual nature of protocol diagrams needsto be underlined
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.]
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]