- From: Maryann Hondo <mhondo@us.ibm.com>
- Date: Tue, 12 Jun 2007 16:30:05 -0600
- To: public-ws-policy@w3.org
- Message-ID: <OF24FBD4A1.84F55A45-ON872572F8.0079C3FB-852572F8.007B5B16@us.ibm.com>
All, I've had several AI's for the Guidelines document, and I have created a strawman for addressing them. I've created a diff doc against the latest version of the Guidelines document to address the following: AI 286 - There has been an ongoing action to deal with the Guidelines document with regard to things we have learned from the WS-Addressing groups efforts to create new assertions. Monica had floated several proposals dealing with context and vocabulary. I tried to incorporate this input into the sections 5.4.2 "Nested Assertions" and Section 8 "Designing Assertions". I may not have captured all the text, but I thought I'd tee this up for discussion AI 303 - propose "bumper sticker text" This one came up at the F2F where we were discussing changes to BP 7. This may seem like a radical change, but when I looked at the table of Best Practices, I couldn't really relate to this list. It seemed very inconsistent in its "guidance". I looked at other BP docs at the W3C and used the I18N one as an example. I took the model of having each item be "Best Practice # - <statement> " I think its now more of a clear "should" or "action" statement ( but am always open to friendly amendments) AI 305- Generalize Best Practice for XML outline I moved a bunch of things around trying to "group" all the best practices that deal with the XML outline section and I included an example from the Reliable exchange document. In doing this I also restructured the "ignorable" and "optional" sections to remove the "general guidance" on defining the attributes ( since this is now in the "general" section) and tried to add text to make the sections be more in parallel. AI 313 - Bug 3978---- Section 7 I still think the Best Practices text in this section should be included. But I think it was in the wrong place. So I propose moving it to Section 5.7 and propose rewording this to be Best Practices for Policy Attachment. Then have a "general" section, and then have a section for "WSDL" specific Best practices. Maryann
Attachments
- application/octet-stream attachment: Web_Services_PolicyGuidelines-strawman-6-12--diff.doc
Received on Tuesday, 12 June 2007 22:27:54 UTC