RE: NEW ISSUE: Terms should be defined/targeted in the appropriate sections of the spec

This issue 3720:
http://www.w3.org/Bugs/Public/show_bug.cgi?id=3720

I recommend that we assign this item to the Editors and have them report back with a proposal at the next distributed meeting on Sep 27.

/paulc

________________________________________
From: public-ws-policy-request@w3.org On Behalf Of Glen Daniels
Sent: September 13, 2006 1:15 PM
To: public-ws-policy@w3.org
Subject: NEW ISSUE: Terms should be defined/targeted in the appropriate sections of the spec

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.

Thanks,
--Glen

Received on Wednesday, 13 September 2006 17:42:11 UTC