[Bug 4300] Misuse of best practices in document

http://www.w3.org/Bugs/Public/show_bug.cgi?id=4300

           Summary: Misuse of best practices in document
           Product: WS-Policy
           Version: FPWD
          Platform: PC
        OS/Version: Windows XP
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Primer
        AssignedTo: fsasaki@w3.org
        ReportedBy: umit.yalcinalp@sap.com
         QAContact: public-ws-policy-qa@w3.org


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.

Received on Monday, 5 February 2007 22:40:24 UTC