Re: Issues with Guidelines Diff (was RE: Candidate Final Drafts: Primer and Guidelines

Asir Vedamuthu wrote:
>
> There are two issues with the generated Guidelines diff doc:
>
> a) The noise level is very high in Section 5.7
>
> b) Diff generator ignores any changes within a best practice mark up.
>
> Felix – do we need to fix any of these for the final publication?
>
no, thanks for checking. I usually re-generate and go through the diffs 
anyway.

Felix
>
> Regards,
>
> Asir S Vedamuthu
>
> Microsoft Corporation
>
> *From:* Asir Vedamuthu
> *Sent:* Monday, October 29, 2007 11:20 AM
> *To:* Maryann Hondo; public-ws-policy-eds@w3.org
> *Subject:* Candidate Final Drafts: Primer and Guidelines
>
> I took an action to prep the candidate final drafts of the Primer and 
> Guidelines documents. I also prepared a draft e-mail (see below) for 
> posting these drafts to the WG. Please review. If there aren’t any 
> issues, as the reporter for this week, Maryann will do the honors of 
> posting these drafts to the WG after 3 PM Pacific today.
>
> Regards,
>
> Asir S Vedamuthu
>
> Microsoft Corporation
>
> ---- draft ----
>
> The editorial team is pleased do deliver candidate final drafts of the 
> Primer and Guidelines documents. These drafts include all the 
> editorial actions assigned until Wednesday, Oct 24^th and the proposed 
> resolution 
> <http://lists.w3.org/Archives/Public/public-ws-policy/2007Oct/0081.html> 
> for issue 5218.
>
> 1. Primer <http://tinyurl.com/26746g> and Primer Diff 
> <http://tinyurl.com/229ldq> (since Sept 28^th Last Call draft)
>
> 2. Guidelines <http://tinyurl.com/24zdqa> and Guidelines Diff 
> <http://tinyurl.com/yspf5v> (since Sept 28^th Last Call draft).
>
> Changes in the Primer are:
>
> A list of editorial changes since the Working Draft dated 28 
> September, 2007 is below:
>
> · Added a UDDI example to *2.10 Referencing Policy Expressions* 
> <http://dev.w3.org/cvsweb/%7Echeckout%7E/2006/ws/policy/ws-policy-primer.html?content-type=text/html;%20charset=utf-8#Referencing_Policy_Expressions>.
>
> · Dropped the terms policy vocabulary and policy alternative vocabulary.
>
> · Dropped an incorrect wsp:Choice example and changed wsp to wsp16 
> prefix in *4. Versioning Policy Language* 
> <http://dev.w3.org/cvsweb/%7Echeckout%7E/2006/ws/policy/ws-policy-primer.html?content-type=text/html;%20charset=utf-8#versioning-policy-language>.
>
> · Updated *C. References* 
> <http://dev.w3.org/cvsweb/%7Echeckout%7E/2006/ws/policy/ws-policy-primer.html?content-type=text/html;%20charset=utf-8#references>.
>
> Changes in the Guidelines are:
>
> A list of major changes since the Working Draft dated 28 September, 
> 2007 is below:
>
> · Clarified the target audience for this document (see *1. 
> Introduction* 
> <http://dev.w3.org/cvsweb/%7Echeckout%7E/2006/ws/policy/ws-policy-guidelines.html?content-type=text/html;%20charset=utf-8#introduction>).
>
> · Moved *20. Semantics Independent of Attachment Mechanisms* 
> <http://dev.w3.org/cvsweb/%7Echeckout%7E/2006/ws/policy/ws-policy-guidelines.html?content-type=text/html;%20charset=utf-8#bp-assertion-semantics> 
> from section *5.1 Assertions and Their Target Use* 
> <http://dev.w3.org/cvsweb/%7Echeckout%7E/2006/ws/policy/ws-policy-guidelines.html?content-type=text/html;%20charset=utf-8#assertion-target> 
> to section *5.7.1 General Guidelines* 
> <http://dev.w3.org/cvsweb/%7Echeckout%7E/2006/ws/policy/ws-policy-guidelines.html?content-type=text/html;%20charset=utf-8#general-attachment-guidelines>.
>
> · Added a new section: *5.3.5 Order of Behaviors* 
> <http://dev.w3.org/cvsweb/%7Echeckout%7E/2006/ws/policy/ws-policy-guidelines.html?content-type=text/html;%20charset=utf-8#order-of-behaviors>.
>
> · Dropped an incorrect ignorable example in section *5.3.2 QName and 
> XML Information Set representation* 
> <http://dev.w3.org/cvsweb/%7Echeckout%7E/2006/ws/policy/ws-policy-guidelines.html?content-type=text/html;%20charset=utf-8#QName_and_XML_Information_Set_representation>.
>
> · Rewrote section: *5.6 Designating Optional Behaviors* 
> <http://dev.w3.org/cvsweb/%7Echeckout%7E/2006/ws/policy/ws-policy-guidelines.html?content-type=text/html;%20charset=utf-8#optional-policy-assertion>.
>
> · Updated *C. References* 
> <http://dev.w3.org/cvsweb/%7Echeckout%7E/2006/ws/policy/ws-policy-guidelines.html?content-type=text/html;%20charset=utf-8#references>.
>
> On behalf of the editorial team,
>

Received on Wednesday, 31 October 2007 15:49:17 UTC