- 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