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

NEW ISSUE: Misuse of best practices in primer

From: Yalcinalp, Umit <umit.yalcinalp@sap.com>
Date: Mon, 5 Feb 2007 14:45:13 -0800
Message-ID: <2BA6015847F82645A9BB31C7F9D64165035336B3@uspale20.pal.sap.corp>
To: <public-ws-policy@w3.org>
Title: Misuse of best practices in document

Description: There are only two best practices in the primer. 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.

See also [Bug 4300]. 

[Bug 4300] http://www.w3.org/Bugs/Public/show_bug.cgi?id=4300
----------------------

Dr. Umit Yalcinalp
Research Scientist
SAP Labs, LLC
Email: umit.yalcinalp@sap.com Tel: (650) 320-3095 
SDN: https://www.sdn.sap.com/irj/sdn/weblogs?blog=/pub/u/36238
--------
"Nearly all men can stand adversity, but if you want to test a man's
character, give him power." Abraham Lincoln. 
Received on Monday, 5 February 2007 22:43:28 GMT

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