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: editorial comments on 101

Title: editorial comments on 101

Editorial changes suggested below:
("Table 26" is the most significant change I suggest)



L68: is not --> are not

"information" is too vague: need at least to say it is part of
the message:
"subset of message data that is intended for the consumer..."

L180: "when invoked, the operation..." -->
"when invoked on a Receiving RMP, the operation..."

L214, L218, L222:
Proposed better wording:
"The XXXX RM-Reply pattern is used if the..."
"When the XXXX RM-Reply pattern is in use, the..."

L222: "..a second" --> "..a separate"

L246: "e.g., For..." --> "e.g. for..."

L383: Appendix A --> Appendix B

Figure 6:
- the annotations "soap:envelope" and "soap:header" are missing
on the right half.
- the comment (L452) should tell more:
"Fig 6 shows the structure... in the SOAP Envelope, for two samples of messages.
On the left side of the figure, a Reliable Message is characterized by the presence of
the wsrm:Request element. On the right side, a response to a Reliable Message
contains a wsrm:Response element. Both wsrm:Request and wsrm:Response elements may be
found in the same message."

Table 26:
"Support matrix", "Supported" are not the appropriate terms:
This table is more about Usage than Capability, but currently mixes both notions,
with capability ("supported") and usage ("disallowed").
It should tell users what reply patterns should be used with what operation type.
It is not about the capability of an RMP, which can in fact support the "disallowed"
case as well, as mentioned in the notes, since the RMP is not required to distinguish
teh operation types.
I suggest to introduce the table as *recommended* usage of <reply pattern / op type>:
L1218: "...One-Way operations can only use.." --> "...One-Way operations should only use.."
Table: replace "Supported" by "Yes", and "Disallowed" by "No" in the table.
L1219: Introduce table as:
"Table 26 indicates the recommended usage of reply patterns, depending on the WSDL operation type. An RMP is REQUIRED to support at least all recommended combinations,

although an RMP is not required to distinguish the operation types."

better wording: replace:
"The Receiving RMP can do whatever..."
"The Receiving RMP may determine its behavior entirely based on message header content,
regardless of the WSDL definition."

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