W3C home > Mailing lists > Public > public-ws-policy@w3.org > January 2007

[NEW ISSUE] 4150 Duplicate text exists in Section 3 and 3.2, PolicyAttachment

From: Monica J. Martin <Monica.Martin@Sun.COM>
Date: Fri, 05 Jan 2007 13:03:56 -0800
To: "public-ws-policy@w3.org" <public-ws-policy@w3.org>
Message-id: <459EBD3C.7020904@sun.com>

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

     Title
Duplicate text exists in Section 3 and 3.2, PolicyAttachments. [1]

     Description and Justification
In the PolicyAttachments document, duplicate text exists in Sections 3 
and 3.2. Section 3 is an introduction whereby Section 3.2 and others 
provide the details. Duplicate text is:

   This section defines two general-purpose mechanisms for associating
   policies with one or more policy subjects.   The first allows
   XML-based descriptions of resources to associate policy  
<http://dev.w3.org/cvsweb/%7Echeckout%7E/2006/ws/policy/ws-policy-attachment.html?content-type=text/html;%20charset=utf-8#policy>
   as part of their intrinsic definition. The second allows policies to
   be associated with arbitrary policy subjects independently from
   their definition.

Most of this text fits in Section 3.2. If revised, Section 3 could serve 
as the introduction.

     Target
Web Services Policy 1.5 - Attachment [2]

     Proposal
Revise Section 3 to minimize duplicative text (given the sections are so 
close together as well). Revised text for Section 3 is provided below. 
No change is needed to Section 3.2.

Change from:

    This section defines two general-purpose mechanisms for associating
    policies with one or more policy subjects.   The first allows
    XML-based descriptions of resources to associate policy  
    <http://dev.w3.org/cvsweb/%7Echeckout%7E/2006/ws/policy/ws-policy-attachment.html?content-type=text/html;%20charset=utf-8#policy>
    as part of their intrinsic definition. The second allows policies to
    be associated with arbitrary policy subjects independently from
    their definition.

    In addition it defines the processing rules for scenarios where
    multiple policies are attached to a policy subject.

Change to:

    This section defines two general-purpose mechanisms for associating
    policies with one or more policy subjects.  In addition it also
    specifies the processing rules for scenarios where multiple policies
    are attached to a policy subject.

[1] Section 3: 
http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/ws-policy-attachment.html?content-type=text/html;%20charset=utf-8#rPolicyAttachment
Section 3.2: 
http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/ws-policy-attachment.html?content-type=text/html;%20charset=utf-8#PolicyAttachmentMechanisms
[2] 
http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/ws-policy-attachment.html?content-type=text/html;%20charset=utf-8

This issue is editorial in nature.
Received on Friday, 5 January 2007 21:04:20 GMT

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