W3C home > Mailing lists > Public > xmlp-comments@w3.org > November 2001

Comments on the SOAP 1.2 Specification

From: Jones, Matthew <MJones@NetSilicon.com>
Date: Fri, 9 Nov 2001 13:13:06 -0500 (EST)
Message-ID: <AD77174F26BFD411BE7B00508BFDF562012461@newbury.netsilicon.com>
To: <xmlp-comments@w3.org>
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
Received on Wednesday, 14 November 2001 05:53:13 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:16:58 UTC