CVS log for 2006/ws/policy/ws-policy-guidelines.xml

Request diff between arbitrary revisions

Pub prep

Incorporated Chris' proposed resolution for issue 5218: drop the second sentence in 21. Describe Semantics of Multiple Assertions of Same Type, "If there are multiple instances of a policy assertion type in the same policy alternative without parameters and nested policies, these have the same meaning as a single assertion of the type within the policy alternative." Editors' action 384.

Updated E. Changes in this Version of the Document.

Applied missed changes (re 5186 and editors' action 374) to B. XML Namespaces and C. References. Fixed the following references:

a) SOAP 1.2
b) Web Services Reliable Messaging
c) Web Services Reliable Messaging Policy Assertion
d) WS-SecurityPolicy and
e) WS-Trust references.

Fixed incorrect changes (re 5184 and editors' action 372):

a) s/Supporting New Policy Subjects/(see Section 6.3 Supporting New Policy Subjects)/ and
b) s/6.3 Supporting New Policy Subjects (see Section 6.3 Supporting New Policy Subjects)/6.3 Supporting New Policy Subjects/

Fixed typos (re 5206 and editors' action 379).

s/Example 1/SignBeforeEncrypting assertion/ and
s/Example 2/EncryptBeforeSigning assertion/ in 5.3.5 Order of Behaviors.

This checkin addresses 3 editor actions: 379, 380, 381

Implemented the resolution for issue 5186.
Editors' action 374
Caveat:
f) WS RM Policy Assertion - does not mention its RDDL
not applicable

Implemented the resolution for issue 5184. Editors' action 372. Implemented as originally proposed b,c,e,f,h,j. Implemented as amended a, k,l. Did not implement g which was not processed by WG.

Implemented the resolution for issue 5185. Editors' action 373.

Implemented the resolution for issue 5128. Editors' action 371. (Fix indentation in example.)

Fixed a bug in the XML Namespaces table - thank you Paul!

Publication preparation related, misc. changes.

Updated Section E Changes in this Version of the Document.

Reset Section E. Changes in this Version of the Document.

Updated WS-Policy and WS-PolicyAttachment references

Implemented the changes proposed by Editors' action 358 issue 5044- attachment best practices

Implemented the resolution for issue 4861.
Editors' action 353 with the caveats and clarifications expressed in message 2007Sep-0002 of the editors mailing list
http://lists.w3.org/Archives/Public/public-ws-policy-eds/2007Sep/0002.html

Implemented the resolution for issue 5043. Editors' action 357.

Picked up W3C REC (http://www.w3.org/TR/2007/REC-ws-addr-metadata-20070904/) for WS-Addressing Metadata

Implemented the resolution for issue 5041. Editors' action: 356.

Add SAG to affiliation

Updated prevloc and references for draft publication.

Fixed a typo: s/Contibution/Contribution/

Fixed a typo

Updated Section E. Changes in this Version of the Document.

Implemented the resolution for issue 4695. Editors' action: 347.

Implemented the resolution for issue 4660. Editors' action: 342.

Implemented the resolution for issue  4859. Editors' action 335.

Updated  Web Services Reliable Messaging Policy reference and WS-Addressing Metadata reference . Editors' action 331.

Implemented the resolution for issue 4654. Editors' action 340. Add new section general-attachment-guidelines.

Implemented the resolution for issue 4862 Editors' actio 348.

4566

bug 4664

Resolution for 4661, 4662, 4861

Removed ednotes, fixed 341

Implemented the resolution for issue 3988. Editors' action: 338, drop Section 7 Scenario and a worked example

Implemented the resolution for issue 3978. Editors' action: 339, drop Section 6 Applying Best Practices for Policy Attachment

Update to section 5.5 for partial resolution of 4661/4462

Implemented the resolution for issue 4852, Editors' action  332.

Implemented the resolution for issue  4853, Editors' action  333.

add code markup and fix typo related to previous checkin -

(Restructured and updated 5.8 Interrelated domains to use Architecture of WWW format and add example, according to Editors' action 309. Updated the WSDL 20 reference [WSDL 2.0 Core Language] and WS-SecurityPolicy reference [WS-SecurityPolicy] for issue 4831. Editors' action 326

Removed one lone "example" sub-heading , making document consistent.)

Restructured and updated 5.8 Interrelated domains to use Architecture of WWW format and add example, according to Editors' action 309. Updated the WSDL 20 reference [WSDL 2.0 Core Language] and WS-SecurityPolicy reference [WS-SecurityPolicy] for issue 4831. Editors' action 326

Removed one lone sug-heading for example, making document consistent.

Implemented place holder for Editors' action 249 to lock the document this week

Implemented Editors' action 295

Implemented Editors' action 289.

Implemented the resolution for issue 4074. Editors' action 286.

edits to close AI 292, 293

Implemented Resolution in Editors' actions 310 and 311

Implemented Resolution in Editors' action 310

Implemented Resolution in Editors' action 308.

Implemented resolution in Editors Action 307

Implemented Resolution in Editors' action 306.

Implemented Resolution in Editors' action 305.

Implemented Resolution in Editors' action 303.

Implemented Resolution in Editors' action 303.

Implemented Resolution in Editors' action 294.

Implemented Resolution in Editors' action 291. Consistent use of should in place of must in the best practice statements

Implemented Resolution in Editors' action 290. Consistent use of Assertion Authors.

Implemented resolution for Isssue 4573 use "Best Practice" everywhere.

WS-A Metadata, bug 4375 Editors AI 284

Added an ed note in Section 5.1 Assertions and Their Target Use that there is an open issue against Good Practice G2.

1. Added Good Practice 26. Specify Composition with Related Assertions (from the IBM and MS Contribution to 5.8 Interrelated domains. Added an ed note that Section 5.8 Interrelated domains needs to be re-structured.

2. Added Good Practice 8. Not Necessary to Understand a Message (from the IBM and MS Contribution to 5.3.3 Self Describing Messages.

3. Added an ed note that Section 5.5 Designating Ignorable Behavior looks incomplete.

4. Fixed typos.

Updated Appendix E, Changes in this Version of the Document

Ensured Good Practices G1, G3 and G20 of original IBM/MS Contribution are reflected.

Editorial changes to get things ready to publish

Restructure the sequencing of WSDL guidelines. They were occuring prior to the explanatory text. This bring sit inline with the order folloed by other sections of the document.

Updated Section 5.4.1 to use the new format re issue issue 3989. Editors' action 230.

Updated Section 5.4.2 to use the new format re issue issue 3989. Editors' action 230. Collapsed Section 5.4.2 and 5.4.3.

Added G11 and G13 to Section 5.4.1 and 5.4.2 re issue issue 3989. Editors' action 252 and 255.

Updated 5.6 WSDL guidelines section to add G19 identified in AI 256 (now G24). Accounts for parts of resolution for issue 3989 corresponding to editors' action item 256 - now complete.

changes to section 5 to add G5,6,9,10  AI's 251,256

Updated 5.1 Assertions and their Target Use for issue 3989 and editors' action item 227.

Updated 5.6 WSDL guidelines section, to follow the new format and added G15, G16, G17 and G18. Accounts for parts of resolution for issue 3989 corresponding to editors' action items 232, 253, and 256.

Reset Section E. Changes in this Version of the Document.

Update section 5.5.1 with new good practices G7 and G8, update TBD in section 2.

Fix up examples using 'HttpsToken RequireClientCertificate' with either true or false. Related to issue 4318 resolution editors AI 245

Editorial changes to align with the OASIS WS-SecurityPolicy specification.

Fixed indentation in XML examples 5-1 and 5-2

Updated 5.2 Authoring Styles for issue 3989 and editors' action item 227

Updated 5.3 "Considerations when Modeling New Assertions" related to issue 3989 [Editorial Action 229] Restructured text to follow examples

minor change to assertion bp based on asir's suggestion

Fixed Good Practice links in section 5.5

Updated 5.5 Designating Optional Behaviors for issue 3989. Added informative reference for MTOMPolicy. Added two best practices, one is similar to G16 but focused on optional. Revised practice that was there

Sec 6.2 and 6.3 of 3989

Added change log entry for David's update of practice stmts. Rebuilt html version with Felix's changes.

AI 223 and 224 done, see http://lists.w3.org/Archives/Public/public-ws-policy-eds/2007Apr/0012.html .

Changed all <p>Best Practice:  to <p role="practice">

link fix for publication

Status update and "previous version link" fix.

Updated entities and previous published WDs for diff generation. Added wsdl11ei to diff task in build.xml . Generated diffs.

Updated or Reset section E. Changes in this Version of the Document.

Primer:
Implemented the resolution for issue 4300. Editors' action 190.

Guidelines:
Implemented the resolution for issue 4319. Editors' action 206.
Implemented the resolution for issue 4212. Editors' action 207.
Implemented the resolution for issue 3990. Editors' action 210.

WS-Policy-Scenarios-Round4
Fixed a bug in the expected outcomes for external policy attachment 4 WSDL 11 test cases. Editors’ action 219.

Pub preparation related changes of entities.

completed editor action item 199 to replace text for bug 4073

Implemented the resolution for issue 3981. Editors' action 205.

Implement resolution for issue 4035, editors action 197.

Implemented the resolution for issue 3979. Editors' action 198.

Implement resolution for issue 3987 (editors action 203).
http://www.w3.org/Bugs/Public/show_bug.cgi?id=3987

Resolution for issue 4072, editors action 204.  http://www.w3.org/Bugs/Public/show_bug.cgi?id=4072

Fixed bug of dangling '#lifecycle' reference

Implemented partial resolution for issue 3987. Related editorial action is 153.

Partial implementation for issue 4072 in response to editor's action 154 . NOTE ALSO- I needed to put back in the "prefix" entity defintion [line7] to get the build to work.

Rolling back ws-policy-guidelines.xml document to the previous version (1.34) to fix broken build. Version 1.35 ws-policy-guidelines.xml triggers a Java Exception from the XML Parser (via Ant).

Added prefix entity

Implement amendment in message 217 with minor editorial modifications for readability of entire sentence. This should complete editors action 152.

Fixed numerous spelling and typo errors. 
Implement resolution for issue 3953 
(http://www.w3.org/Bugs/Public/show_bug.cgi?id=3953)
as noted in message 90 and amendment in message 217.
(http://lists.w3.org/Archives/Public/public-ws-policy/2006Dec/0090.html and http://lists.w3.org/Archives/Public/public-ws-policy/2007Jan/0217.html)
Changes correspond to editor's action 152.

Fixed SAWSDL ref name

Action 126, Resolution of 4188

Action 119. Resolution of 4141 is implemented by adding a reference to the framework document in 4.4.1. instead

Action item 137, Resolution of Issue 4198

Completed Action 144, Resolutions for 3985 and 3986

Completed Editors AI 127, implement resolution for issue 4197 in the guidelines document.

Reset - Section "Changes in this Version of the Document".

Fix for 3980

Fix for 3982, minor editorial fix for use of "Assertion Author"

implemented changes for editor action 106, bug entry 3983, reconciling terms for "Assertion Authors"

Editorial revision: completed missing parts of editorial action 96 after editorial reviews by co-editors.

Editorial revision: most parts of editorial action 96 from MS review.
Remaining editorials to be reviewed.

Example formatting in sec. 4.2 and sec. 8, updated change log accordingly.

Two changes:

a) Formatted examples in 5.2 Evolution of Assertions (Versioning and Compatibility).
b) Updated change log to record all the paper trails for revisions 1.16, 1.17 and 1.18

Additional edit to fix versioning examples and additional editorial bug as noted in Asir;s action 90 part 2

Editorial revision related to editorial actions 84 and 90

Minor change to introduction text to check build process.

Replace ",where each policy alternative is" with "with each policy alternative a"

trivia- corrected formatting in comment

changes to lifecycle section as per editorial action 77

Updated the list of editors. Added Frederick [1] and Umit [2] to the list of editors. Editors' action 86 [3].

[1] http://lists.w3.org/Archives/Public/public-ws-policy-eds/2006Nov/0033.html
[2] http://lists.w3.org/Archives/Public/public-ws-policy-eds/2006Nov/0054.html
[3] http://www.w3.org/2005/06/tracker/wspolicyeds/actions/86

updates as per open actions 64 and 77, related to f2f resolution3792 and bugzilla entry 3705 - restructure guidelines & incorporate primer sections

first pass at updating as per editor action item 77

Fixed a reference

Assertions for optional behaviors take 2

Fixes for Frederick's comments (20061025)

Fixes based on PC's feedback on Oct 20th

fixed xml issues (wellformed/valid)

updated with editorial changes & examples

corrected syntax problems

Fixed references, namespaces, incorporated changes suggested by Frederick, added par to self-describing messages

Deleted placeholder for automatically generated example numbers.

Made changes proposed by Paul at http://lists.w3.org/Archives/Public/public-ws-policy/2006Oct/0050.html . Changed also the name of the documents ws-policy-assertion-guidelines.html and ws-policy-assertion-guidelines.xml to ws-policy-guidelines.xml and ws-policy-guidelines.html .