RE: [NEW ISSUE]: 4203 Introduction misleading (Framework)

This editorial change looks good to me. Please assign this one to the
editors.

 

Regards,

 

Asir S Vedamuthu

Microsoft Corporation

 

 

From: public-ws-policy-request@w3.org
[mailto:public-ws-policy-request@w3.org] On Behalf Of Christopher B
Ferris
Sent: Friday, January 12, 2007 8:12 AM
To: public-ws-policy@w3.org
Subject: [NEW ISSUE]: 4203 Introduction misleading (Framework)

 


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

Title: Introduction misleading

Description: The last paragraph in the introduction to the WS-Policy 1.5
Framework discusses WS-Policy 1.5 - Attachment. However, I believe that
it is
somewhat misleading in its intent. Specifically, I think that the
terminology
used should be consistent with the defined terms in our glossary.
Secondly, I
believe that we should reorder the sentences to make it clear that
WS-Policy
1.5 Attachment defines certain attachment mechanisms and policy scopes
and
subjects and that other specs are free to define OTHER attachment
schemes for
policy subjects and scopes not covered in WS-Policy 1.5 Attachment.
Otherwise,
we are effectively encouraging a potential interoperability nightmare.

Justification: see above

Type: editorial

Proposal:

change:
Web Services Policy 1.5 - Framework does not specify policy discovery or
policy
attachments. A policy attachment is a mechanism for associating policy
with one
or more policy scopes, where a policy scope is a collection of policy
subjects
to which a policy may apply. A policy subject is an entity (e.g., an
endpoint,
message, resource, interaction) with which a policy can be associated.
Other
specifications are free to define technology-specific mechanisms for
associating policy with various entities and resources. Web Services
Policy 1.5
- Attachment [Web Services Policy Attachment] defines such mechanisms,
especially for associating policy with arbitrary XML elements [XML 1.0],
WSDL
artifacts [WSDL 1.1, WSDL 2.0 Core Language], and UDDI elements [UDDI
API 2.0,
UDDI Data Structure 2.0, UDDI 3.0]. 

to:
Web Services Policy 1.5 - Framework does not cover discovery of policy,
policy
scopes and subjects, or their respective attachment mechanisms. A policy
attachment is a mechanism for associating policy with one or more policy
scopes. A policy scope is a collection of policy subjects to which a
policy
applies. A policy subject is an entity (e.g., an endpoint, message,
resource,
interaction) with which a policy can be associated. Web Services Policy
1.5 -
Attachment [Web Services Policy Attachment] defines such mechanisms,
specifically for associating policy with arbitrary XML elements [XML
1.0], WSDL
artifacts [WSDL 1.1, WSDL 2.0 Core Language], and UDDI elements [UDDI
API 2.0,
UDDI Data Structure 2.0, UDDI 3.0]. Other specifications are free to
define
either extensions to the mechanisms defined in Web Services Policy 1.5 -
Attachment, or additional mechanisms for purposes of associating policy
with
policy scopes and subjects not covered by Web Services Policy 1.5 -
Attachment. 

Cheers, 

Christopher Ferris
STSM, Software Group Standards Strategy
email: chrisfer@us.ibm.com
blog: http://www.ibm.com/developerworks/blogs/page/chrisferris
phone: +1 508 377 9295