[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: [Editorial] ToC and Section 1
Line 31 There should be some whitespace between the subsection numbers and the subsection titles in the Table of Contents. Section 1.5, Relation to Other Specifications --------------------------------------------- Line 141 Change 'base protocol' to 'base protocols'. Section 1.6, Examples of Messages Compliant with WS-Reliability -------------------------------------------------------- Line 174 Add '/>' at the end of the line to close the SequenceNum tag. Section 1.7, Terminology ------------------------ Line 271 Change '(or RMP)' to '(RMP)' Line 286 Use "Keep with Next" (or whatever the StarOffice style name is) to keep titles with their text. Line 288 Add a period at the end of the line. Line 305 Change 'PollRequest' to 'a PollRequest'. Line 307 Add a comma after 'E.g.'. Line 311 The first sentence describing what an Acknowledgment message contains is not defining terminology and should be removed. Line 317 Remove the first sentence describing the contents of the message. Lines 325, 330, 334 Change 'We say that the' to 'The'. 'We say that' is more suitable to an academic paper than to a standard. Section 1.8.1, Definition ------------------------- Line 343 Add a comma after 'RM Agreement'. Line 344 Remove the comma after 'receiver RMP'. Lines 345, 346 Change 'the' to 'The' and add a period at the end of line 345 to better match the capital-and-period style of other lists. Line 354 Change 'i.e.' to 'I.e.,' (including the comma). Line 355 Change 'messages, in order' to 'messages'. Change 'requirements these' to 'requirements to which these'. Line 356 Remove 'to'. Section 1.8.2, RM Agreement Items --------------------------------- Lines 360, 361 Move the stuff in parentheses to a note following the list item. The parenthetical explanation breaks up the sentence too much where it is. Line 364 Change 'message protocol, i.e. map to some message header, some will not' to 'message protocol (i.e., map to some message header) and some will not.' Lines 368 to 385 If the Agreement Items are not defined as API calls by this spec, then the words making up their names should be jammed together. For example, 'GuaranteedDelivery' should be 'Guaranteed Delivery'. Lines 369, 371, 373 Add a space between 'Section' and the section number. Lines 374, 377, 383 The meaning of 0 seconds is undefined. Is it an instant, less than 1 second, or a signal that there is no limit to the duration? Similarly, the explanation allows negative integers. Line 381 The explanation allows a negative number. Section 1.8.3, Messaging Scope of Agreement Items ------------------------------------------------- Line 410 Change 'above' to 'shown'. Regards, Tony Graham ------------------------------------------------------------------------ Web Products, Technologies and Standards Phone: +353 1 8199708 Sun Microsystems x(70)19708 East Point Business Park, Dublin 3, Ireland
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]