Add note on included and pagination (#1744)

* Add note on included and pagination

* Update docs/usage/reading/pagination.md

Co-authored-by: Bart Koelman <[email protected]>

---------

Co-authored-by: Bart Koelman <[email protected]>

Author: bjornharrtell

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).