Re: Draft SOAP Primer with MTOM additions

Nilo, 

I finally got to read your draft and I have a few comments. Overall, I
think it's a very good piece of text.

Section 4 mentions the property for optimization candidates which AFAIK
is gone now.

At the beginning of section 5.3, is the reference to
"content-transfer-encoding scheme defined in rfc 2045" necessary?
Wouldn't it be sufficient just to say "transform the binary data into
character representation of type xs:base64Binary"?

I think the text before section 5.3.2, especially the second para in
5.3, will want to mention XOP.

First para under example 18: "many thousands of orders of magnitude" -
?!? 8-)

Also first para under example 18 says that the element areaMap is a
sub-element of soap:Body, is that correct though? Is a sub-element a
child or a descendant? Anyway, the listing of children of the Body a few
paragraphs below should be cleared in presentation to indicate that
hotel and areaMap are not, in fact, children of Body. A sub-list, maybe.

The remark in parentheses after the listing says other types may be
optimized, that's been eliminated, IIRC.

Finally, will section 5.3.3 be expanded or is it intended to be so
short? If the latter, should it maybe be merged with one of the previous
sections?

Best regards,

                   Jacek Kopecky

                   Systinet Corporation
                   http://www.systinet.com/






On Fri, 2004-01-16 at 17:40, Nilo Mitra (NY/EMX) wrote:
> Hello everyone:
> The W3C XMLP WG is exploring the idea of an update to the SOAP Primer Rec to 
> include MTOM/XOP(MIFFY) etc., and I offered to provide a proposal. I have 
> produced a draft editor's copy of the SOAP Primer with MTOM additions [1], 
> which I hope the you can review and comment on. 
> 
> Very briefly, the changes from the original Primer Rec (suitably highlighted) 
> are
> 1) the addition of a new section 5.3 ("Optimized serialization of SOAP 
> messages") to the existing section 5 ("Advanced usage scenarios") which 
> contain three subsections on the abstract feature, the format and the binding
> 2) some minor improvements to the description of features and properties etc, 
> in section 4 and pointers to section 5.3
> 3) section 1 and references: additions to reference and describe the added 
> specs
> 4) incorporated all the accepted errata comments on the SOAP Primer Rec  
> 
> Please keep in mind while commenting that, as with the original Primer, it is 
> written for those not intimately associated with the process of creating or 
> reading the specifications, and must therefore, while being accurate, 
> describe things with somewhat broader brush strokes and keeping with the flow 
> of the original text and scenarios. Also, as MTOM/MIFFY->XOP is a work in 
> progress, the primer is naturally a little behind. That said, **all errors 
> are mine**, and this work has not been reviewed by the WG.
> 
> However, it should give you a general idea of what an expanded SOAP1.2 primer 
> might contain.
> 
> Thanks, and I look forward to your comments on [1],
> Nilo
> [1] http://www.w3.org/2000/xp/Group/04/1/soap12-part0-with-MTOM-additions.html
> 
> Nilo Mitra
> Ericsson, Inc.
> phone: +1 212-843-8451
> mobile: +1 516-476-7427
> nilo.mitra@xxxxxxxxxxxx
>