OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

wsrm message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Non-exhaustive proofreading pass on 1.05 spec



  I've grouped these suggestions into categories; you can take or leave
any of them.  None of them should change the meaning of the spec in any
way.

  I've structured each suggestion in a 3 line format.  The first line
lists the line number, followed by a description of the change; the
second line lists the current reading of the spec; the third my revised
wording.

Mark Peel
Web Services Infrastructure
Novell, Inc.


Typos:

264 -- change "A" to lower case
(e.g., A transport connection)
(e.g., a transport connection)

297 -- capitalize "way"
One-way
One-Way

982 -- change "D" in "groupID" to lower case
@groupID
@groupId

990 -- change "D" in "groupID" to lower case
@groupID
@groupId

1303 -- capitalize "way"
One-way
One-Way

1316 (Table 26) -- capitalize "way"
One-way
One-Way


Formatting:

1022-1023 -- eliminate line break separating "numb" from "er" (a
backslash stands for the line break in illustrations)
sequence numb\er 15
sequence number \15


Omissions:

105 -- insert omitted space between "Processor" and "(RMP)"; make
"Reliable Message Processor" and "RMP" plural
the two Reliable Messaging Processor(RMP) they use.
the two Reliable Messaging Processors (RMPs) they use.

216 -- insert omitted comma between "is" and "either"
Reliable Message, that is either an
Reliable Message, that is, either an

752 -- insert dash after "Poll" to close parenthetical material
RM-Reply Patterns -- Response, Callback and Poll are
RM-Reply Patterns -- Response, Callback and Poll -- are


Form: 

253 -- Omit "The", capitalize "four", and enclose "Submit, Deliver,
Respond and Notify" in parenthesis
The four operations Submit, Deliver, Respond and Notify are used
Four operations (Submit, Deliver, Respond and Notify) are used


Grammar/punctuation:

146 -- change "expressed" to "expressing them" (avoids the switch of
sentence subject)
features, expressed as
features, expressing them as

262-263 -- move "or not" from after "matched" to after "whether"
knowledge of whether an invocation of Deliver will be matched or not
by
knowledge of whether or not an invocation of Deliver will be matched
by

1003-1005 -- move "either" before "are"; use parenthesis to enclose the
2 parenthetical clauses instead of dashes
referred to are either acknowledged - in which case @fault MUST NOT be
present - or have encountered a particular,common fault condition - in
which case @fault MUST be present.
referred to either are acknowledged (in which case @fault MUST NOT be
present) or have encountered a particular,common fault condition (in
which case @fault MUST be present).



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]