[Bug 187] New: Wsdl, request/reply, fields

[bugzilla-daemon@arjuna.com]

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

           Summary: Wsdl, request/reply, fields
           Product: WS-CF
           Version: 1.0
          Platform: PC
               URL: http://www.choreology.com/external/ws-
                    cf.choreology_comments.htm#CHCF-29
        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:  Several places

The text shows the wsdl for the various services, which is uninformative, just
repeating which messages are part of which porttype (which is clearly stated in
succinct paragraphs of the text) and with mechanical operation:message
relationships (it might be slightly useful if it showed which were
contextualized, but it doesn’t)

On the other hand, which messages are responses to which has to be teased out of
the body of the text, and which fields are in each message can only be found by
examining the schema, with attendant alignment problems.

Suggestion:  Remove the wsdl from the text, add tables of what is reply to what,
include a list of fields for each message with short statement of what it does.

(This is partly an application here of changes made/in process in ws-context)



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