Add note on included and pagination (json-api-dotnet#1744)

bjornharrtell · bkoelman · web-flow · commit 8c59d1b640fe · 2025-07-17T00:14:31.000+02:00
* Add note on included and pagination

* Update docs/usage/reading/pagination.md

Co-authored-by: Bart Koelman &lt;10324372+bkoelman@users.noreply.github.com&gt;

---------

Co-authored-by: Bart Koelman &lt;10324372+bkoelman@users.noreply.github.com&gt;
diff --git a/docs/usage/reading/pagination.md b/docs/usage/reading/pagination.md
@@ -18,6 +18,10 @@ and on included resources, for example:
 GET /api/blogs/1/articles?include=revisions&page[size]=10,revisions:5&page[number]=2,revisions:3 HTTP/1.1
 ```
 
+> [!NOTE]
+> For optimal performance, pagination links and total meta are not returned for *included* to-many relationships.
+> See [here](https://github.com/json-api-dotnet/JsonApiDotNetCore/issues/1738) for details.
+
 ## Configuring Default Behavior
 
 You can configure the global default behavior as described [here](~/usage/options.md#pagination).
