W3C home > Mailing lists > Public > public-ws-policy@w3.org > July 2006

NEW ISSUE: Clarify "Framework" in Introduction

From: William Henry <william.henry@iona.com>
Date: Thu, 13 Jul 2006 11:54:54 -0600
Message-Id: <E7A8E65C-E324-4E97-B0A2-A5F24FE6055B@iona.com>
To: public-ws-policy@w3.org

Title - Clarify the difference between Web Services Policy and Web  
Services Policy 1.5 - Framework in the Introduction

Description -

It isn't clear what Web Services Policy Framework is in the context  
of WS-Policy in this introduction. There is no specific Web Services  
Policy specification. Rather Web Services Policy is the working group  
developing specifications on the area called Web Services Policy. The  
specifications are both the Framework and the Attachment  
specification. Therefore the first sentence "Web Services Policy  
provides a flexible and extensible grammar for expressing the  
capabilities, requirements, and general characteristics of entities  
in an XML Web services-based system. " seems either erroneous or  
vague. Assuming it's correct then surely a clarifying sentence could/ 
should be added.

I looked at other WS- working groups and hadn't seen Framework before.

Target section 1 Introduction

Proposal -

After the sentence "Web Services Policy provides a flexible and  
extensible grammar for expressing the capabilities, requirements, and  
general characteristics of entities in an XML Web services-based  
system." Add "Web Services Policy defines two specifications: Web  
Services Policy Framework and Web Services Policy Attachment."

Otherwise make it clear outside the document that the Framework is  
really the primary specification of WS-Policy.

I prefer to make it clearer in the introduction.

It does beg the question should this be Web Services Policy Framework  
1.5 instead of Web Services 1.5 Framework. As I said I couldn't see  
this type of naming in other WS- specification. Perhaps there is but  
I couldn't find them with a quick look around.

The motivation here is just to make it explicit for people new to WS- 
Policy that the Framework document is the primary specification. [I  
am not saying that to belittle the Attachment specification]
Received on Thursday, 13 July 2006 18:23:14 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:20:40 GMT