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

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 UTC