[v1.3] Sort facets value by alphanumerical or count order

[brunoocasali]

⚠️ This issue is generated, it means the examples and the namings do not necessarily correspond to the language of this repository.
Also, if you are a maintainer, please add any clarification and instructions about this issue.

Sorry if this is already wholly/partially implemented. Feel free to let me know about the state of this issue in the repo.

Related to meilisearch/integration-guides#280

---

This issue is divided into two sections, first, you need to make the implementation, and second, you must update the code-samples (no one likes outdated docs, right?).

New implementation

Related to:

• issue: Sort facets value by alphanumerical or count order meilisearch#3612
• discussion: Retrieve facet values sorted by the number of corresponding documents product#519 (comment)
• spec: Faceting Setting API - sortFacetValuesBy  specifications#247

Adds the ability to sort facets by their value which could be by using alpha or count.

Ensure the SDKs can handle the new index faceting configuration attribute sortFacetValuesBy. This enum could only take count or alpha.

The faceting configuration now have two attributes:

maxValuesPerFacet: integer
sortFacetValuesBy: object 
  index_name: alpha|count
  *: alpha|count // when should be applied to all indexes

Code samples

Inside of this file: .code-samples.meilisearch.yml:

1. Create a new entry with this key facet_search_2 containing a call to the updateFaceting settings method.
   With this value: "sortFacetValuesBy":{"genres": "count"}

Use this as a reference if the previous description was not helpful:

facet_search_2: |-
  PATCH 'http://localhost:7700/indexes/books/settings/faceting' 
  with data: {
    "sortFacetValuesBy": {
      "genres": "count"
    }
  }

2. Update getting_started_faceting key to contain the new behavior sortFacetValuesBy

getting_started_faceting: |-
  PATCH 'http://localhost:7700/indexes/movies/settings/faceting' 
  with data: {
    "maxValuesPerFacet": 2,
    "sortFacetValuesBy": {
      "*": "count"
    }
  }

3. Update update_faceting_settings_1 key to contain the new behavior sortFacetValuesBy

update_faceting_settings_1: |-
  PATCH 'http://localhost:7700/indexes/books/settings/faceting' 
  with data: {
    "maxValuesPerFacet": 2,
    "sortFacetValuesBy": {
      "*": "alpha",
      "genres": "count"
    }
  }

TODO:

• Add the ability receive a new param in the updateFaceting settings method called sortFacetValuesBy.
• Update the code-samples accordingly
• Add integration tests

[curquiza]

Let me know if I'm wrong @brunoocasali, but this feature is already available in the SDK without doing anything?

[brunoocasali]

yes @curquiza you're right, it was only missing the code-samples that you introduced in the #486 so I'm closing it now!