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