W3C home > Mailing lists > Public > xml-dist-app@w3.org > October 2001

comments on the primer proposal draft

From: Christopher Ferris <chris.ferris@sun.com>
Date: Wed, 10 Oct 2001 15:44:57 -0400
Message-ID: <3BC4A539.40608@sun.com>
To: xml-dist-app@w3.org
Nilo,

Some comments on the Primer draft.

Cheers,

Chris

- With regards to the following:

	Part 1 of the SOAP 1.2 specifications defines the SOAP envelope, ...
	It also defines a transport binding framework, which describes the
	way by which a SOAP message may be carried as the payload of another
	protocol.

Suggested replacement text:

	Part 1 of the SOAP 1.2 specifications defines the SOAP envelope, ...
	It also defines a transport binding framework, which describes a
	framework for the specification of a binding of SOAP onto another
	underlying protocol such as HTTP, SMTP, etc.

- With regards to the following:

	It is fundamentally a stateless, one-way message exchange paradigm...

I think that "It" needs to be qualified. I believe that the "It" here refers
to SOAP, not the XML Document of the previous sentence. Suggested replacement
text:

	SOAP is fundamentally a ...

- With regards to section 1.2 Notational Conventions. Is it customary to
include reference to RFC2119 in a non-normative document such as the primer?
I note that the XMLSchema Primer does not do so...
Received on Wednesday, 10 October 2001 15:48:21 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 7 December 2009 10:59:04 GMT