[Bug 207] New: Justification and tutorial inappropriate

[bugzilla-daemon@arjuna.com]

http://services.arjuna.com/wscaf-issues/show_bug.cgi?id=207

           Summary: Justification and tutorial inappropriate
           Product: WS-CF
           Version: 1.0
          Platform: PC
               URL: http://www.choreology.com/external/ws-
                    cf.choreology_comments.htm#CHCF-49
        OS/Version: Windows XP
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Text and diagrams
        AssignedTo: ws-caf@lists.oasis-open.org
        ReportedBy: tony.fletcher@choreology.com
         QAContact: mark.little@arjuna.com


Where: General

Much of the text is material justifying the utility of transactions or
coordination, or tutorial material that refers only to particular kinds of
coordination (such as classic transaction systems). This perversely obscures
what normative requirements are made and functions supported by the WS-CF spec
and should not be in the main body of the document (if in it at all). The
different explanations of how the concepts and players relate to each other
sometimes contradict as well (particular cases have been mentioned in other issues)

Suggestion:  Describe (once) the model of how activity/context, coordinator,
participant, Coordinator Service etc. relate to each other. Remove any text that
refers to transaction systems as if they were normative elements of WS-CF
implementations.  (Consider updating the Primer.)



------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.