Improve README with pagination information (#120)

* Improve README with pagination information

* Update README.md

* Update README.md

Co-authored-by: cvermand <[email protected]>

Co-authored-by: cvermand <[email protected]>

Author: curquiza

README.md

@@ -60,13 +60,14 @@ const searchClient = instantMeiliSearch(
 );
 ```
 
-- `paginationTotalHits` (`200` by default): The total (and finite) number of hits you can browse during pagination.<br>
-It means, by default, you can browse `paginationTotalHits / hitsPerPage = 200 / 20 = 10` pages during pagination.<br>
-By default, `hitsPerPage` is set to `20` but it can be changed with [`InsantSearch.configure`](https://www.algolia.com/doc/api-reference/widgets/configure/js/#examples)<br>
-If the pagination widget is not set, this parameter is ignored.
-
 - `placeholderSearch` (`true` by default). Displays documents even when the query is empty.
 
+- `paginationTotalHits` (`200` by default): The total (and finite) number of hits you can browse during pagination when using the [pagination widget](https://www.algolia.com/doc/api-reference/widgets/pagination/js/). If the pagination widget is not used, `paginationTotalHits` is ignored.<br>
+Which means that, with a `paginationTotalHits` default value of 200, and `hitsPerPage` default value of 20, you can browse `paginationTotalHits / hitsPerPage` => `200 / 20 = 10` pages during pagination. Each of the 10 pages containing 20 results.<br>
+The default value of `hitsPerPage` is set to `20` but it can be changed with [`InsantSearch.configure`](https://www.algolia.com/doc/api-reference/widgets/configure/js/#examples).<br>
+⚠️ MeiliSearch is not designed for pagination and this can lead to performances issues, so the usage of the pagination widget is not encouraged. However, the `paginationTotalHits` parameter lets you implement this pagination with less performance issue as possible: depending on your dataset (the size of each document and the number of documents) you might decrease the value of `paginationTotalHits`.<br>
+More information about MeiliSearch and the pagination [here](https://github.com/meilisearch/documentation/issues/561).
+
 ## Example with InstantSearch
 
 The open-source [InstantSearch](https://www.algolia.com/doc/api-reference/widgets/js/) library powered by Algolia provides all the front-end tools you need to highly customize your search bar environment.