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

[NEW ISSUE] 4230 normative text masquerading as non-normative guidance (Attachment)

From: Christopher B Ferris <chrisfer@us.ibm.com>
Date: Mon, 15 Jan 2007 19:26:20 -0500
To: public-ws-policy@w3.org
Message-ID: <OF1FCE9D01.753EC680-ON85257265.000203EB-85257265.0002664A@us.ibm.com>
http://www.w3.org/Bugs/Public/show_bug.cgi?id=4230

Title: normative text masquerading as non-normative guidance (Attachment)

Description: Section 3.3 of the attachment spec contains notmative text 
that
appears on the surface as non-normative guidance (a MUST that hides behind 
a
"Note that ...").

Also, the text seems to be limited to use of the PolicyURIs attribute, 
however,
I don't believe that was the intent. I believe that it was intended to 
place a
constraint on policy attachment authors, that they MUST define the policy 
scope
of the attachment.

Justification: See above. Normative text should not begin with "Note" as 
it
seems to suggest editorial commentary.

Type: editorial

Proposal:

Change:

Note that the policy scope of the attachment is specific to the policy
attachment Mechanism using it; accordingly, any policy attachment 
mechanism
using this attribute MUST define the policy scope of the attachment.

To:

The policy scope of an attachment is specific to the policy attachment
Mechanism using it. Accordingly, any policy attachment mechanism MUST 
define
the policy scope of the attachment.

and, relocate the paragraph from section 3.3 to section 3.2

Cheers,

Christopher Ferris
STSM, Software Group Standards Strategy
email: chrisfer@us.ibm.com
blog: http://www.ibm.com/developerworks/blogs/page/chrisferris
phone: +1 508 377 9295
Received on Tuesday, 16 January 2007 00:27:19 GMT

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