[Fwd: Comments on V0.98]

[Colleen Evans <cevans@progress.com>]

This went out Friday before the deadline, but
was rejected by the list server.  
Colleen

-------- Original Message --------
Subject: Comments on V0.98
Date: Fri, 09 Mar 2001 17:55:08 -0700
From: cevans@progress.com
Organization: Progress Software Corporation
To: ebxml-transport@lists.ebxml.org
CC: "David A. Chappell" <chappell@progress.com>,Charlie
Nuzzolo <cnuzzolo@progress.com>,Jaime Meritt
<jmeritt@progress.com>, Ray Chun <rchun@progress.com>

Here are our comments from Progress / Sonic Software.

I've attached a formatted list in a Word document, but for
those who don't have Word, the comments are inline below
(divided into Substantive and Editorial).

Best regards,
Colleen
------------------------------------------------------
Substantive Comments:
------------------------------------------------------

326 Via element (section 8.7) should be added at SOAP Header
extension level

814 Should VIA element be added to Section 8.14 (Combining
ebXML SOAP Extension Elements)?

1007 #wildcard is an element of Manifest, but it is not
described in section 8.11 at that level.  It also is listed
at the Reference (child of Manifest) element level, and is
described in that section (line 1062).  Should it be a child
of both Manifest and Reference as currently represented, or
is that an error?  If it is not an error, then a reference
for #wildcard needs to be added at the upper level.

1232, 1253, 1281, and 1298 Should Via element be added as an
ebXML Header element for Message Status Request Message,
Message Service Handler Ping Message, and Message Service
Handler Pong Message?

1230, 1235, 1249, 1256, 1279, 1284, 1295, and 1301 Should be
“Message Header” rather than “Header”

2317 Product / vendor specific reference (MQSeries) – please
delete and use JMS or something that is not product
specific.


-------------------------------------------------------------------

Editing Comments
-------------------------------------------------------------------

? (p.3) Section 2 – Bob Miller should be GXS (not GSX)?

2 Remove the word ‘the’ in the phrase “…is the one of a
series”

16-18 RFC 2068 and RFC 821 mentioned – not listed as
references in section 13.

45 Bold italics also represent SOAP elements – change
wording to delete “of the XML ebXMLHeader”

77 Add familiarity with SOAP as an assumption?

81 Should this be ebXML Transport, Routing and Packaging:
Overview and Requirements, [TRPREQ] instead of ebXML Message
Services Requirements Specification [EBXMLMSREQ]?  If not,
[EBXMLMSREQ] is not referenced in section 13.

132 Spell out Message Service Handler before “(MSH)”, as
this is the first occurrence of the term and three letter
acronym.

141 Add [SOAPATTACH] reference

180 Delete space at beginning of paragraph

188 RFC 2387 is not listed in section 13

233 Remove this paragraph.  Appendix B Examples is no longer
included.

256-259 Align vertical lines on right

327 SOAP Message should be in italics

363-364 Add spacing between paragraph and example

522 Missing reference to section 10

537 Should this reference be to section 11 – error handling
– rather than section 10?

572 Last line of example got pulled into header – needs to
be put back in example.

575 SequenceNumber should be in italics

641 First reference should be section 8.6.4, not 8.6.3.5

685 Add reference to Timestamp at Message Header level
(8.5.6.2)

779 Heading (section 8.7 Via) should be bold

787 Either delete value for version number here, or it
should be “0.98” – see line 814

809-810 Last sentence is not clear

830 Reference should be to 10.1.2 (see line 693 – same
element – references 10.1.2; and 1394 which also references
10.1.2)

844 Add reference to CPAId definition in Message Header

855 “Service” and “action” should be in bold italics

875 “attribute” should not be in bold italics

1102 Add reference to Timestamp formatting details at
Message Header level (8.5.6.2)

1119-1123 Fix bullets to match rest of document

1132 Delete empty bullet

1133 “Acknowledgement” element should be in bold italics

1145 Add reference to Timestamp formatting details at
Message Header level (8.5.6.2)

1352, 1370 From Party should be capitalized and in italics,
not bold

1355, 1369, 1382 To Party should be capitalized and in
italics, not bold

1361 From Party and To Party should be capitalized and in
italics, not bold

1362 Remove highlight

1373 Add space between “syncReply” and “is”

1395 Should be “reliableMessagingMethod attribute shall have
one of the following values” not “…value shall have one of
the following values”

1619 Space between section and 11.4 in reference

1876 Add location for glossary

2342 Fix spacing and delete highlight on reference

Sonic feedback to v0.98 030901.doc