Issue PR026: Editorial comments on WS-SecurityPolicy Public Reviewdocument

[[ 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