Comments on the SOAP 1.2 Specification

I have the following comments on the SOAP 1.2 Part 2: Adjuncts document

1.  There is no grammar for describing the structure of a SOAP Message.
There should be a rigorous definition of the structure of the document.
The definition of the structure should include the standard encoding.
The document http://www.w3.org/2001/09/soap-encoding is not adequate.
The preferred strategy would be an EBNF grammar.  I do not feel the
Schema is up to the task and since a SOAP document contains fragments
there is circularity or ambiguity issue.

2.  Section 4.4.2 does not describe how to encode arrays.  The first
example in that section shows a schema and an xml document conforming to
that schema.  It has nothing to do with SOAP encoding.  There is no
reason to ever put an XML Schema in this section it only confuses the
issue, and there is no motivation or explanation why they are there.
What should be there is a rigorous specification of the various ways
that an array can be defined uses that standard encoding.  Providing
multiple examples and lazy and doesn't belong in the core of a
specification (an appendix maybe).  If you can't figure out how to
provided a rigorous specification using, for example, and EBNF then it
is not ready for standardization.

Virtually every section has a similar problem to sections 4.4.2.

I you are serious about providing a useful specification then you will
rewrite the specification to make it a formal specification rather than
a document full of commentary and examples.

Matthew Jones
mjones@netsilicon.com

Received on Wednesday, 14 November 2001 05:53:13 UTC