Skip to content

Commit a1edb31

Browse files
Apply suggestions from PR review
Co-authored-by: Jeffrey Richter <[email protected]>
1 parent 395a83b commit a1edb31

File tree

1 file changed

+2
-1
lines changed

1 file changed

+2
-1
lines changed

azure/ConsiderationsForServiceDesign.md

+2-1
Original file line numberDiff line numberDiff line change
@@ -376,7 +376,7 @@ Finally, write sample code for your service's workflow and add the code you'd wa
376376

377377
## Pagination
378378

379-
Operations that return a collection of resources may need should support pagination.
379+
Operations that return a collection of resources must consider pagination.
380380
There are hard limits to the payload size of HTTP responses, and when the size of a collection or the resources themselves
381381
can grow arbitrarily large there is the risk of exceeding this limit if the operation does not support pagination.
382382
Further, adding support for pagination is a breaking change so it should be supported in the initial GA of the service
@@ -385,6 +385,7 @@ if there is any possibility that it will eventually be needed.
385385
There are two forms of pagination that MAY be supported by RESTful APIs.
386386
Server-driven paging mitigates against denial-of-service attacks by forcibly paginating a request over multiple response payloads.
387387
Client-driven paging enables clients to request only the number of resources that it can use at a given time.
388+
Services should almost always support server-driven paging and may optionally support client-driven paging.
388389

389390
### Server-driven paging
390391

0 commit comments

Comments
 (0)