Issue PR026: Editorial comments on WS-SecurityPolicy Public Reviewdocument

[Greg Carpenter <gregcarp@microsoft.com>]

[[ gleaned from the spreadsheet of SP PR comments posted at http://lists.oasis-open.org/archives/ws-sx-comment/200704/msg00000.html ]]

Protocol:  ws-securitypolicy

http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/ws-securitypolicy-1.2-spec-cd-02-diff.pdf

Artifact:  spec / schema

Type: editorial

Title: Editorial comments on WS-SecurityPolicy Public Review document

Description:

section 1.4.1 -- line 129
The text appears to be truncated. The RFC reference is omitted.
Proposal: Add the RFC 2119 reference.

sections 5.2.1, 5.2.2 -- lines 727, 732:
It references attribute, while it is talking about an element.
Proposal: Change "attribute" to "element".

section 5.2.4 -- line 752 :
Strange text "to as multiple tokens as it sees fit."
Proposal: Change text "to as many tokens as it sees fit." Or change to ", and apply to as many tokens as it sees fit."

section 5.4.1 -- line 832 :
Slash "/" is missing.
Proposal: Add "/" before "sp:Issuer".

section 5.4.7 -- line 1255:
wsp:Policy is now required, and its contents are optional. But the "?" is in the wrong place.
Proposal: Put the "?" on line 1257 rather than on line 1255.

sections 8.2, 8.3, 8.4 -- lines 2297, 2352, 2409:
Spurious "|" symbol.
Proposal: Delete the "|" symbol or add ellipses after it "...".

section 10.1 -- line 2773 :
Confusing text.
Proposal: Clarify the text "element is a policy assertion indicates", maybe by adding "that" before "indicates".

Related issues:

None.

Proposed Resolution:

See Description