proposed revision text for sect 1.5.3

All,

I am not thrilled with the current prose in section 1.5.3 which reads:

<current>
1.5.3 Service Description
The mechanics of the message exchange are (partially) documented in a 
Web service description (WSD). (See Figure 1.) The service description 
is a machine processable specification of the message formats, 
datatypes and protocols that should be used between the requester 
agent and the provider agent. It also specifies the network location 
of the provider agent, and may provide some information about the 
message exchange pattern that is expected.
</current>

I would offer the following substitution text:

<proposed>
1.5.3 Service Description
The mechanics of the message exchange are documented in a 
Web service description (WSD). (See Figure 1.) The WSD is an extensible 
machine 
processable specification of the message infosets and features that 
comprise
the Web service's interface and the binding(s) of those message infosets 
and features to the serialization format(s) and transfer or transport 
protocol(s) 
supported by the Web service's endpoint(s). It also specifies the 
set of endpoints that each expose a network addressable binding to a 
specific serialization format and transport or transfer protocol of the 
Web service interface to the service functionality implemented by the 
provider agent. 
</proposed>

First off, I thought that the parenthetical "(partially)" was unnecessary 
for our 
purposes and somewhat derogatory towards WSDL which is still being
developed and yet which is IMO sufficiently extensible to allow whatever
might be missing to be added to the WSD by means of the extensibility
points.

Secondly, I was uncomfortable with "the specification of the formats, 
datatypes,
and protocols..." as being somewhat vague and imprecise.

Comments?

Cheers,

Christopher Ferris
STSM, Emerging e-business Industry Architecture
email: chrisfer@us.ibm.com
phone: +1 508 234 3624

Received on Saturday, 31 May 2003 10:12:06 UTC