Update .changeset/fresh-tables-clap.md

Co-authored-by: Guillaume Mourier <[email protected]>

Author: bidoubiwa

.changeset/fresh-tables-clap.md

@@ -11,12 +11,12 @@
 Currently, for each `facet value` selected in a different `facet` a separate request is made to Meilisearch. Plus, an additional one containing all the facets filters. It results in tedious search requests and a high bandwidth cost.
 For example, if I select `Adventure` on genres and `Multiplayer` on players, one request is made with both facet filters, one with only `genres=Adventure` and one with only `players=Multiplayer`
 
-In the next release of Meilisearch, the `multi-index` route should be released (see [PR](https://github.com/meilisearch/meilisearch/pull/3417)). When it is released, the work-around will be removed and only one request will be done in all cases!
+In the next release of Meilisearch, a new `multi-search` API route is planned to be released (see [PR](https://github.com/meilisearch/meilisearch/pull/3417)). When it is released, the work-around will be removed and only one HTTP request will be done in all cases!
 
 
-## Explaination
+## Explanation
 
-The way the `facet distribution` is calculated changed. The `facet distribution` shows the numbers of hits for each facet. For example:
+The way the `facetDistribution` is calculated changed. The `facetDistribution` shows the numbers of hits for each facet. For example:
 
 Given the following facet:
 
@@ -25,7 +25,7 @@ Genres
 - [ ] Adventure 7
 ```
 
-The `facet distribution` provides the information that there are 7 hits containing the adventure genre.
+The `facetDistribution` provides the information that there are `7` hits containing the adventure genre.
 
 For the example, let's take the following facets:
 
@@ -50,7 +50,7 @@ Players
 - [ ] Single player 3
 ```
 
-In the new behavior the distribution number are not changed when facet values are selected inside the same facet.
+With the new behavior, the distributed number are not changed when facet values are selected inside the same facet because a facet distribution is computed with a dedicated search request.
 
 ```
 Genres
@@ -74,4 +74,4 @@ Players
 
 This is the conventional way of calculating the facet distribution. Similar to Algolia's behavior. If you prefer the old behavior, please consider opening an issue.
 
-See [complete explaination here](https://github.com/meilisearch/instant-meilisearch/issues/884)
+See [complete explanation here](https://github.com/meilisearch/instant-meilisearch/issues/884)

.changeset/rich-wasps-tell.md

@@ -8,4 +8,4 @@
 
 Currently, for each index a request is made on, a separated request is made to Meilisearch. For example, if you have two indexes on which to search, two http requests are made.
 
-In the next release of Meilisearch, the `multi-index` route should be released (see [PR](https://github.com/meilisearch/meilisearch/pull/3417)). When it is released, the work-around will be removed and only one request will be done in all cases!
+In the next release of Meilisearch, a new `multi-search` API route is planned to be released (see [PR](https://github.com/meilisearch/meilisearch/pull/3417)). When it is released, the work-around will be removed and only one HTTP request will be done in all cases!

README.md

@@ -676,7 +676,7 @@ The `refinementList` widget is one of the most common widgets you can find in a
 - ✅ cssClasses: The CSS classes to override.
 
 The `RefinementList` widget uses the `disjunctive facet search` principle when using the `or` operator. For each different facet category used, an additional http call is made.
-For example, if I ask for `color=green` and `size=2`, three http requests are made. One for the hits, one for the `color` distribution and one for the `size` distribution. To provide any feedback on the subject, refer to [this discussion](https://github.com/meilisearch/product/issues/54).
+For example, if I ask for `color=green` and `size=2`, three http requests are made. One for the hits, one for the `color` facet distribution, and one for the `size` facet distribution. To provide feedback on the subject, refer to [this discussion](https://github.com/meilisearch/product/issues/54).
 
 The following example will create a UI component with the a list of genres on which you will be able to facet.