This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 3720 - Terms should be defined/targeted in the appropriate sections of the spec
Summary: Terms should be defined/targeted in the appropriate sections of the spec
Status: CLOSED FIXED
Alias: None
Product: WS-Policy
Classification: Unclassified
Component: Framework (show other bugs)
Version: FPWD
Hardware: PC Windows XP
: P2 normal
Target Milestone: ---
Assignee: Felix Sasaki
QA Contact: Web Services Policy WG QA List
URL: http://www.w3.org/mid/80A43FC052CE394...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2006-09-13 17:21 UTC by Glen Daniels
Modified: 2006-10-12 23:08 UTC (History)
0 users

See Also:


Attachments

Description Glen Daniels 2006-09-13 17:21:44 UTC
(Mail thread for this issue begins at http://www.w3.org/mid/80A43FC052CE3949A327527DCD5D6B2701E6B3A2@MAIL01.bedford.progress.com)

Title: Terms should be defined/targeted in the appropriate sections of the spec

Description:  The editors took an action at the last F2F to define terms such as "policy", "policy alternative", etc, at the point which they are first referenced in the Framework spec.  This has caused the introduction to become very difficult to read, and links to be less than clear.  We should fix this.

Justification:  Although with best intentions, the change in the current drafts really didn't work as hoped.  The introduction is cluttered and hard to read, and the links to terms such as "policy" go back there instead of to the place where they are truly specified (sec 3.3 for "policy").

Target: WS-Policy Framework

Proposal:  We should remove the definitions and brackets from the introduction, and have all usages of the terms we define (even in the introduction) link to the sections where those terms are normatively defined.  For "policy" this would be section 3.3, for "policy assertion" section 3.1, etc.  This would mirror usage seen in other specs, and make the document much cleaner.
Comment 1 Christopher Ferris 2006-09-27 16:17:25 UTC
Assigned to the editors... when it is resolved in an ED, we can close this
Comment 2 Paul Cotton 2006-10-04 16:37:33 UTC
Resolved to adopt option 3 from David Orchard's email:
http://lists.w3.org/Archives/Public/public-ws-policy/2006Oct/0013.html
at the Oct 4 meeting:
http://www.w3.org/2006/10/04-ws-policy-irc#T16-27-31-2

/paulc