[Bug 3965] Clarify text surrounding PolicyReference and for usage of wsp:Name attribute

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





------- Comment #1 from fabian.ritzmann@sun.com  2006-12-05 15:35 -------
Updated proposal:


Title

Clarify text surrounding PolicyReference and cover wsdl:import use


Description

See Justification and Proposal


Justification

The description of retrieving policy references seems mislocated in section 3.2
(normalization). wsdl:import is used frequently in real WSDL documents and
should be covered when policy references are discussed.


Target

Primer

Note: At some point, if section 5.1 of the Guidelines is extended, the
Guidelines may be affected.


Proposal

1.a)

Create a new section after section 3.5. Name the new section "3.6 Policy
Retrieval".

Move the entire block of text in Section 3.2 to the newly created section 3.6:

"Just as other service metadata languages, Web Services Policy does not mandate
any specific policy retrieval mechanism ... If the referenced policy expression
is in the same XML document as the reference, then the policy expression should
be identified using the wsu:Id (XML ID) attribute and referenced using an IRI
reference to this XML ID value."

1.b)

Add a reference to the end of section 3.2: "See section 3.6 for more details
how to retrieve referenced policy expressions."

2.

Add to the end of the newly created section 3.6:

WSDL 1.1 [WSDL 1.1] section 2.1 and WSDL 2.0 [WSDL 2.0 Core Language] chapter 4
allow to import or include WSDL documents into another WSDL document with the
wsdl11:import, wsdl20:import, and wsdl20:include statements. The importing and
imported WSDL documents constitute separate XML documents each. If e.g. the
importing WSDL document references a policy in the imported WSDL document, the
rules for policy references between separate XML documents apply as described
in section 2.8. 

Received on Tuesday, 5 December 2006 15:36:00 UTC