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

NEW ISSUE: 3980 [Guidelines] Should Assume Basic Understanding of WS-Policy

From: Asir Vedamuthu <asirveda@microsoft.com>
Date: Fri, 17 Nov 2006 17:41:50 -0800
Message-ID: <1E0F0378382054439F14D5450650478F0B5447CC@RED-MSG-42.redmond.corp.microsoft.com>
To: <public-ws-policy@w3.org>

Title: The introduction section should state that the Guidelines
document assumes a basic understanding of the Web Services Policy
language.

Description: The introduction to the Guidelines document states that
'This document assumes a basic understanding of XML 1.0, Namespaces in
XML, WSDL 1.1 and SOAP' [1]. This document is for assertion authors. We
should assume that assertion authors have a basic understanding of the
Web Services Policy language.

Justification: The introduction should be clear about what we expect
from the target audience.

Target: Guidelines for Assertion Authors.

Proposal:

Replace
'This document assumes a basic understanding of XML 1.0, Namespaces in
XML, WSDL 1.1 and SOAP'

With
'This document assumes a basic understanding of XML 1.0, Namespaces in
XML, WSDL 1.1, SOAP and the Web Services Policy language. Web Services
Policy 1.5 - Primer provides an introductory description of the Web
Services Policy language.'

[1]
http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/ws-policy-guidelines.
html?rev=1.8&content-type=text/html;%20charset=utf-8#introduction


Regards,

Asir S Vedamuthu
Microsoft Corporation
Received on Saturday, 18 November 2006 01:42:22 GMT

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