Re: [sca-bindings] ISSUE-79: BWS20016 should not be normative

[Simon Nash <oasis@cjnash.com>]

Anish,
I'm fine with this change.

   Simon

Anish Karmarkar wrote:
> 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
> 
> ---------------------------------------------------------------------
> 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
> 
>