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 4300 - Misuse of best practices in primer
Summary: Misuse of best practices in primer
Status: RESOLVED FIXED
Alias: None
Product: WS-Policy
Classification: Unclassified
Component: Primer (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:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2007-02-05 22:40 UTC by Umit Yalcinalp
Modified: 2007-03-27 22:59 UTC (History)
0 users

See Also:


Attachments

Description Umit Yalcinalp 2007-02-05 22:40:05 UTC
Title: Misuse of best practices in document

Description: There are only two best practices in the document. They appear to be in the document because the sections they are included were moved from the guidelines document. This makes the document inconsistent in style. 

Justification: 

The document style is inconsistent. Including only 2 best practices is rather funny. 

Proposal: 

-- Either include best practies to other sections or remove the best practices in the Primer. My preference is the latter. 

-- Move the best practice for assertion versioning to the guidelines document. This is a guideline for the assertion authors.
Comment 1 Christopher Ferris 2007-03-13 21:38:47 UTC
[17:28] cferris: RESOLUTION: 4300 closed with the following change:
[17:28] dmoberg: cferris: any objections to editors' action as discussed and then for closing 4300? None voiced
[17:28] cferris: 1. change section 3.10 to section 4
[17:28] cferris: add 4. Versioning Policy Language is intended to provide examples and best practices on versioning of the policy language itself, mostly intended for policy implementers 
[17:28] cferris: to intro
[17:28] cferris: rrsagent, where am i?
[17:28] RRSAgent: See http://www.w3.org/2007/03/13-ws-policy-irc#T21-29-46
Comment 2 David Orchard 2007-03-27 22:59:56 UTC
I sent a message to Umit and cc'ed the public comments list.