[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [sca-bindings] ISSUE-79: BWS20016 should not be normative
One minor proposed change inlined below. -Anish -- Eric Johnson wrote: > Logged as: http://www.osoa.org/jira/browse/BINDINGS-79 > > -Eric. > > Simon Nash wrote: >> TARGET: Web Services Binding Specification >> >> DESCRIPTION: BWS20016 should not be normative >> >> The normative statement BWS20016 reads as follows: >> >> The @wsdli:wsdlLocation attribute MAY be specified by the binding in >> the event that the <WSDL-namespace-URI> in the ‘endpoint’ attribute >> is not dereferencable, or when the intended WSDL document is to be >> found at a different location than the one pointed to by the >> <WSDL-namespace-URI>. [BWS20016] >> >> The use of MAY in this statement does not conform to RFC2119, which >> states that MAY represents an optional feature that implementations >> are free to either support or not support. In this case, the >> @wsdli:wsdlLocation attribute is required to be supported by all >> implementations (as stated in BWS20021), and the MAY is attempting >> to convey the fact that users can choose whether or not to use >> this feature of SCA. >> >> PROPOSAL: >> >> Convert the normative statement BWS20016 into a non-normative >> statement, and also fold the first sentence from BWS20018 into this >> paragraph. The resulting text for the /binding.ws/@wsdli:wsdlLocation >> bullet would be: >> >> /binding.ws/@wsdli:wsdlLocation – when present this attribute >> specifies the location(s) of the WSDL document(s) associated with >> specific namespace(s). >> >> The @wsdli:wsdlLocation attribute can be used in the event that >> the <WSDL-namespace-URI> is not dereferenceable, or when the intended s/the <WSDL-namespace-URI> is not dereferenceable/<WSDL-namespace-URI> value in the @wsdlElement attribute is not dereferenceable/ >> WSDL document is found at a different location than the one pointed to >> by the <WSDL-namespace-URI>. The semantics of this attribute are >> specified in Section 7.1 of WSDL 2.0 [WSDL20]. >> >> If the @wsdli:wsdlLocation attribute is used, the @wsdlElement >> attribute MUST also be specified. [BWS20017] >> >> The value of the @wsdli:wsdlLocation attribute MUST identify an >> existing WSDL 1.1 document. [BWS20018] >> >> ***Note that I have made some minor wording and spelling updates to >> the above, including removing the incorrect reference to the >> ‘endpoint’ attribute*** >> >> Simon >> >> >> >> --------------------------------------------------------------------- >> To unsubscribe from this mail list, you must leave the OASIS TC that >> generates this mail. Follow this link to all your TCs in OASIS at: >> https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php > > --------------------------------------------------------------------- > To unsubscribe from this mail list, you must leave the OASIS TC that > generates this mail. Follow this link to all your TCs in OASIS at: > https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php >
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]