RE: QA Review on WSDL 2.0 Part 1, intro and conformance issues

Le mar 21/09/2004 à 20:21, Jonathan Marsh a écrit :
> At our recent FTF, we resolved most of your remaining comments as detailed below.  We will assume you accept these resolutions if we don't receive an explicit acknowledgement by 1 October.

My answers below to the issues you resolved (I removed the ones without
resolutions yet). Thanks for having taken the time to look at those!

> > I suggest that you give a specific label to this class of WSLD
> > processors, à la "WSDL 2.0 requesting processor" - you'll probably find
> > something better.
> 
> We agreed to reword the paragraph to remove "class" distinctions (since we only define one class) as follows:
> 
> 'This section defines conformance of a WSDL processor. In this section, the term "WSDL processor" refers to a processor that is acting on behalf of a party that wishes to make use of a Web service (i.e., the requester entity or requester agent, rather than the party that implements the Web service (i.e., the provider entity or provider agent).'
> 
> [See http://www.w3.org/2002/ws/desc/4/lc-issues/#LC5d]

OK; I'd rather have seen 2 classes of processor (requester and server),
but I trust the WG if it thinks it's not worth it.

> > * "a conformant WSDL processor MUST accept any legal WSDL document":
> > what is a legal WSDL document? I suggest saying "conformant WSDL
> > document" - but I'm still unclear whether you define that at all in the
> > section above
> 
> We agreed we're a bit lax on our terminology here.  We agreed to add a definition of WSDL Document as a wsdl:definitions element and its descendents.  This would likely appear in the notational conventions section (1.3) and section 8.1 can be simplified accordingly.  We also agree to change "legal" to "conforming" wsdl document.

Thanks, I'm satisfied by this.

> > * "a conformant WSDL processor MUST either agree to fully abide": I
> > think this an abusive usage of MUST, since "agreeing" is not an
> > operation that a WSDL process does; I would suggest "a conformance WSDL
> > processor MUST immediately cease processing (fault) if it doesn't agree
> > to fully abide ...."
> 
> We accepted your suggestion.

Thanks,

> > * the "Note:" under this defines conformance requirements for a provider
> > agent, which is out of scope for the given section; I suggest creating a
> > different section, even if that's the only requirement for it
> 
> We agreed to delete the note from the conformance section (as redundant), promote the material on optional extensions into its own section, and add "See section ___ for further explanation".

OK; I guess I'll wait and see what the actual implementation in the spec
looks like; could you ping me when you have something I can look at? I
think this shows there are still some conformance requirements needed
for server processors, but this may be proved to be wrong when reading
the actual text.

> > * the section 6.1 on mandatory extensions adds requirements both for
> > requesting and providing processors; most are duplicated in the
> > conformance section, but I think a few are not (e.g. "the provider agent
> > MUST support every extension, Feature or Property that is declared as
> > optional in the WSDL document"); I suggest they should be added to the
> > conformance section
> > http://www.w3.org/TR/2004/WD-wsdl20-20040803/#mandatoryext
> 
> We believe the resolution to LC5i addresses this issue as well.

(as above)

> > *likewise, section 4.1 makes a suggestion for processors:
> > "Processors are encouraged to keep track of the source of component
> > definitions, so that multiple, mutual, and circular includes do not
> > require establishing identity on a component-by-component basis."
> > http://www.w3.org/TR/2004/WD-wsdl20-20040803/#includes
> > Maybe this could be added as a SHOULD in the conformance section
> 
> This text is only intended as advice to implementers. We agreed to delete it.

Please don't; I was simply suggesting this would make a useful SHOULD,
but I'd rather see it in its current shape than not seeing it at all.

> [See http://www.w3.org/2002/ws/desc/4/lc-issues/#LC5k]
> 
> > * section 1.1 reads "All parts of this specification are normative, with
> > the EXCEPTION of notes, pseudo-schemas, examples, and sections
> > explicitly marked as "Non-Normative"."; some of the "Note:"s include
> > normative-like language, e.g.
> > "Support for the W3C XML Schema Description Language [XML Schema:
> > Structures],[XML Schema: Datatypes] is required of all processors."
> 
> The intent is that this statement reinforce the conformance requirement stated in the conformance section.  As such, the Working Group didn't want to promote or delete the note, instead clarifying that it is simply a forward reference by changing "processors" to "conformant processors", and linking to the conformance section.

OK, I'm satisfied by this.


> > "If a WSDL document declares an extension or feature as optional, then
> > if that extension or feature could apply to messages sent by the
> > provider agent as well, then the provider agent MUST NOT send any
> > messages that requires the requester agent to support that extension or
> > feature."
> > Please fix.
> 
> The Working Group agreed to make the Note in 6.3 normative, and rephrase as "Extensibility elements SHOULD NOT alter the existing semantics in ways that are likely to confuse users."

OK, thanks.

Dom
-- 
Dominique Hazaël-Massieux - http://www.w3.org/People/Dom/
W3C/ERCIM
mailto:dom@w3.org