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

 


Help: OASIS Mailing Lists Help | MarkMail Help

provision message

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


Subject: Spec Draft 11 review comments.


I found a few things to correct in the text.  I've already addressed 
these for draft 12, but I am posting them to the list in case anyone 
disagrees with one (or wants to discuss specifics).

78.  Consistently use XML element font for enclosing brackets.
79. line 661: "existing object that exists on a target" is redundant.
80. line 1705: deleteResponse returns "requestID" (not "asyncRequestID").
81. line 1739: statusRequest MUST return status of (not cancel) the 
operation.
82. line 1799: response for pending must contain *initial* subset of output.
83. line 1908: Section 7.3.6 does not exist. Paragraph is redundant.  
Rewrite.
84. line 1917: No such as batchableRequest.  Relabel as "Nested requests".
85. line 1919: batchRequest MUST contain at least one request.
    Combine this sentence with the previous sentence.
86. line 1928: Add spmlupdates:UpdatesRequestType, IterateRequestType
    and CloseIteratorRequestType to the list that must not be batched.
87. line 2007: delete unmatched parenthesis in "described by a) nested".
88. line 2216: setPassword must change password for (not enable) object.
89. line 2268: expirePassword invalidates password for (not enables) object.
90. line 2316: must should be all capitals (because it is normative).
91. line 2360: validatePassword tests the value (not changes password).
92. line 2363: delete paragraph (copied from resetPassword).
93. line 2528: complexType RacfGroupMembership should be 
RacfGroupMembershipType.
94. line 2571: complexType RacfGroupMembership should be 
RacfGroupMembershipType.
95. line 2585: complexType RacfGroupMembership should be 
RacfGroupMembershipType.
96. line 2784 (and throughout): "status set" should be "result set".
97. line 2834 (and in section): iterate returns next set of items (not 
next item).
98. line 2869: Clarify time when "one object remains".  Tense is ambiguous.
99. line 2872: Clarify time when "no object remains".  Tense is ambiguous.
100. line 2919 (and in section): searchResponse should be iterateResponse.
101. line 2933: Remove "requestor cannot specify "ID". Confusing.
102. line 3427: Remove "requestor cannot specify "ID". Confusing.
103. line 3464 (and in section): iterateResponse returns updates (not 
objects).
104. line 3484 (and in section): "updates set" should be "result set".
105. line 3507 (and in section): iterate returns next set of items (not 
next item).
106. line 3516: Clarify time when "one object (update) remains".  Tense 
is ambiguous.
107. line 3519: Clarify time when "no object (update) remains".  Tense 
is ambiguous.
108. line 3524: Remove "PSO and ReturnData" section. Copied from search 
iteration.
109. line 3524: Remove "PSO capability-specific Data..." section.
110. line 3580: Remove "requestor cannot specify "ID". Confusing.



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