[Bug 4253] [Primer] Basic Concepts section on Policy does not explain usage reasonably

http://www.w3.org/Bugs/Public/show_bug.cgi?id=4253





------- Comment #1 from william.henry@iona.com  2007-02-14 16:48 -------
Proposal - add the following text to section 2-2 - Replace the paragraph under
example 2-2 with the following and modify the subsequent example numbers by
incrementing.

The policy expression in the above example consists of a Policy main element
and a child element wsap:UsingAddressing. Child elements of the Policy element
are policy assertions. Contoso attaches the above policy expression to a WSDL
binding description.

Example 2-3. Policy Expression Attached to Binding
<wsdl:binding name="AddressingBinding" type="tns:RealTimeDataInterface" >
  <Policy>
    <wsap:UsingAddressing />
  </Policy>
  ...
</wsdl:binding>

Policies can also be attached to WSDL using references (See 2.10 Attaching
Policy Expressions to WSDL.)

<----END OF TEXT ---->
HTML for the editors to add:

The policy expression in the above example consists of a <code>Policy</code>
main element and a child element <code>wsap:UsingAddressing.</code> Child
elements of the <code>Policy</code> element are policy assertions. Contoso
attaches the above policy expression to a WSDL binding description.</p><div
class="exampleOuter"><p style="text-align: left"
class="exampleHead"><i><span>Example 2-3. </span>Policy Expression Attached to
Binding</i></p><div class="exampleInner"><pre>&lt;wsdl:binding
name="AddressingBinding" type="tns:RealTimeDataInterface" &gt;
  &lt;Policy&gt;
    &lt;wsap:UsingAddressing /&gt;
  &lt;/Policy&gt;
  ...
&lt;/wsdl:binding&gt;</pre></div></div>

Policies can also be attached to WSDL using references (See <a
href="#attaching-policy-expressions-to-wsdl"><b>2.10 Attaching Policy
Expressions to WSDL</b></a> ).

Received on Wednesday, 14 February 2007 16:49:00 UTC