Strawman for AI 286, 303, 305, 313

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 
 
 

Received on Tuesday, 12 June 2007 22:27:54 UTC