Comments on SOAP 1.2 part 2

Here are some comments related to part 2 of the specification. I have used
the Editor's copy dated Mar 23 2002.

Abstract
There is no mention of features, transport binding framework or the HTTP
binding so for simplicity remove the final sentence.

Introduction
In bullet 4 there is no mention of sections 5 and 6 for the binding
framework.
Suggest new bullet 4:
The SOAP Protocol Binding Framework (see 5 A Convention for Describing
Features and Bindings and 6 Message Exchange Patterns) defines a way of
describing SOAP bindings to underlying transport protocols.
New bullet 5:
The SOAP HTTP Binding defines a binding of SOAP to HTTP [2] following the
rules of the SOAP Protocol Binding Framwork (see 7 SOAP HTTP Binding).

Section 2 The SOAP Data Model
First sentence:
"The SOAP Data Model represents information ....."
No mention of what type of information the data model represents. Suggest:
"The SOAP Data Model represents instance information ....."

Section 2.1 Graph Edges
Problem here in mixing the use of the word node. This section uses it in
the graph theoretic sense, the last sentence of section 2 uses it as a SOAP
Node !! Is there another word the mathematicians use to identify a graph
"node" ? Not sure there is.

Section 2.3 Values
Bullet 1:
Rewrite as "A non-terminal is known as "generic" if the labels of its
outbound edges are not unique ......."
Bullet 2:
Rewrite as "A non-terminal whose outbound edges are distinguished solely by
their labels is known as a "struct"."

Section 3.1.3 Encoding compund values
Typo space missing "..... an array node MAY have ....."

Section 3.1.4.3 Constraints on id and ref attribute information items
We constrain the value of a ref attribute to be the value of exactly one id
attribute. Does the converse apply ? That we cannot have ids without a
matching ref ?

Apologies for missing the Friday deadline,
John

Emerging ebusiness Industry Architecture ,
XML Technology and Messaging,
IBM UK Ltd, Hursley Park,
Winchester, SO21 2JN

Tel: (work) +44 (0)1962 815188        (home) +44 (0)1722 781271
Fax: +44 (0)1962 816898
Notes Id: John Ibbotson/UK/IBM
email: john_ibbotson@uk.ibm.com

Received on Monday, 8 April 2002 16:57:14 UTC