[Bug 3980] [Guidelines] Should Assume Basic Understanding of WS-Policy

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

           Summary: [Guidelines] Should Assume Basic Understanding of WS-
                    Policy
           Product: WS-Policy
           Version: FPWD
          Platform: PC
        OS/Version: Windows XP
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Guidelines
        AssignedTo: fsasaki@w3.org
        ReportedBy: asirveda@microsoft.com
         QAContact: public-ws-policy-qa@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.

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

Received on Saturday, 18 November 2006 01:17:52 UTC