Merge branch 'jramsay/notes-api-pagination-docs' into 'master'

Add pagination to notes and discussions docs

Closes #51616

See merge request gitlab-org/gitlab-ce!27401

doc/api/discussions.md

@@ -2,6 +2,13 @@
 
 Discussions are set of related notes on snippets, issues, merge requests or commits.
 
+## Discussions pagination
+
+By default, `GET` requests return 20 results at a time because the API results
+are paginated.
+
+Read more on [pagination](README.md#pagination).
+
 ## Issues
 
 ### List project issue discussions

doc/api/notes.md

@@ -2,6 +2,13 @@
 
 Notes are comments on snippets, issues or merge requests.
 
+## Notes pagination
+
+By default, `GET` requests return 20 results at a time because the API results
+are paginated.
+
+Read more on [pagination](README.md#pagination).
+
 ## Issues
 
 ### List project issue notes