Re: Guidelines Document

Umit

Thanks for the update.

I noticed that the following comments were not addressed (the others  
were), thus I think some more changes might be needed.

Comments on Content

1) Add wsp:Policy elements to Example 8.4 CompanyAProfileB (fully  
expanded), and also example 8.6
- wsp:Policy element required as child of sp:TransportBinding and  
parent of sp:TransportToken, since sp:TransportToken is an assertion.

4) Add guidance as to when and why to use parameters versus nested  
assertions. I think it would make the document flow better and be  
clearer if section 5.4 "Assertions with Parameters" were to be  
combined with 5.5 "Comparison of Nested and Parametrized Assertions"  
and placed before 5.3 "Nested Assertions". This could answer the  
question of when to use parameters versus  nested assertions before  
getting into the details of nested assertions.

5) Add description and guidance related to policy and SOAP  
intermediary processing, before section 5.6 Self Describing Messages

Editorial comments

2) Pretty-print (indent) all xml for readability
8) 2.1.3 s/can reflect its on the wire/can specify its on-the-wire/
15) 5.4 1st bullet

s/which can not/that cannot/

16) 5.6
put last paragraph first removing "REWRITEAs a result,". This last  
paragraph is the main concept. Tighten earlier material.

(i.e, this is first:
As a result, Policy assertions should not be used to express the  
semantics of a message. If a property is required to understand a  
message, it should be communicated in the message, or be made  
available by some other means(e.g., being referenced by a URI in the  
message) rather than communicated as a policy element.)


regards, Frederick

Frederick Hirsch
Nokia


On Oct 19, 2006, at 7:57 PM, ext Yalcinalp, Umit wrote:

> All,
>
> Please find the first version of the guidelines document in [1] and  
> send comments/issues.
>
> Frederick, would you verify the comments you have raised has been  
> adressed to your satisfaction.
>
> Regards,
>
> --umit
>
> [1] http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/ws-policy- 
> guidelines.html?content-type=text/html;%20charset=utf-8
>
> ----------------------
>
> Dr. Umit Yalcinalp
> Architect
> NetWeaver Industry Standards
> SAP Labs, LLC
> Email: umit.yalcinalp@sap.com Tel: (650) 320-3095
> SDN: https://www.sdn.sap.com/irj/sdn/weblogs?blog=/pub/u/36238
>

Received on Wednesday, 25 October 2006 15:57:53 UTC