A few comments on Arvola's comments on 1.0.7 and a few other comments.
Line 313, Reference to ebMSREQ: I agree with Arvola. You cannot reference
a document which isn't published and available to anyone reading the
specification. You also can't simply ask OASIS to publish this one because
it is undoubtedly far out of date. I suggest capturing any needed points
in ebMSREQ and putting them into the spec.
Line 328: I agree with Arvola. A specification can't reference itself.
Square brackets are reserved for pointing to the reference list. Usually
one says "this specification" rather than using a pseudo-reference acronym.
Line 1355: we have often used something like [ebCPPA] as an object when
the object of the sentence is a specification. I this case, the object is
an XPointer, not the XPointer specification.
Line 1447: This section title is "Optional Features". In RFC2119 terms
(which this specification says it conforms to), OPTIONAL means that vendors
do not have to implement the feature in question. Does the MSG team intend
that vendors be free to implement or not implement the functions in this
section? If not, find a word that is not on the RFC2119 list. Please
treat this is an issue, not as a comment to the technical editor.
Line 1636: Please check all mentions of the version attribute for
references to section 0. I found at least one that Arvola didn't call out.
Reference list: All references to ebXML specifications should include the
current URLs. If the reference is post-v 1.0, it may have an OASIS URL
instead of the original ebXML URL.
Regards,
Marty
*************************************************************************************
Martin W. Sachs
IBM T. J. Watson Research Center
P. O. B. 704
Yorktown Hts, NY 10598
914-784-7287; IBM tie line 863-7287
Notes address: Martin W Sachs/Watson/IBM
Internet address: mwsachs @ us.ibm.com
*************************************************************************************
Arvola Chan <arvola@tibco.com> on 11/01/2001 09:34:04 PM
To: ebXML Msg <ebxml-msg@lists.oasis-open.org>
cc:
Subject: Re: [ebxml-msg] ebXML Message Service Specification
David:
Please see my embedded editorial comments.
Regards,
-Arvola