Merge #2043 #2044

2043: comparison of implicit vs. explicit index creation r=maryamsulemani97 a=maryamsulemani97

closes #873 

2044: Remove`learn/configuration/settings.md` r=maryamsulemani97 a=maryamsulemani97

closes #1614 

## Update

- We decided to go with 3 
## What is this PR doing?
- Removes all unused code samples
- Updates links from `/learn/configuration/settings.md` to API reference 
- Uses the same table in the API reference and `/learn/configuration/settings.md`
- Adds "developer-friendly syntax" to the "Body" of each setting in the API reference
~- Moves "developer-friendly syntax"(`displayedAttributes=[<String>, <String>, ...]`) to a new column "Format" in the table in `/learn/configuration/settings.md`~
  ~- I don't like how the table looks because of the "Format" column, and "Type" and "Format" are talking about the same thing:~
     ~- Should we remove "Type"? I think it's a lot easier to process compared to "Format"~
     ~- Orrr we could have the same table as the[ API reference](https://docs.meilisearch.com/reference/api/settings.html#body)? It will be easier to update too. Update one table and copy it to the other~
     ~WDYT `@guimachiavelli` `@dichotommy?~`

<hr>

1. We get rid of `/learn/configuration/settings.md`

![Screen Shot 2022-12-13 at 15 46 40](https://user-images.githubusercontent.com/90181761/207309694-8c9080f4-280f-421e-b330-3b4178aaa200.png)
  
  - The guides seem to pop out of nowhere. We could rename the "Index settings" heading to something more suitable.
2. Only keep `/learn/configuration/instance_options.md` under Configuration. Move the guides to "Advanced topics"

![Screen Shot 2022-12-13 at 15 54 12](https://user-images.githubusercontent.com/90181761/207311112-5706e7fd-ec78-4c38-a0a8-88269059367f.png)

 - The guides are very different from the current content under "Advanced topics". Should we create a new heading?
 - Makes it look like there isn't any content under "Configuration"

3. We only keep the ["Index settings"](/learn/configuration/settings.html#index-settings) table in  `/learn/configuration/settings.md`
- The reader will get a summary of the different settings without having to go to another page, and we can keep the guides here




Co-authored-by: Maryam Sulemani <[email protected]>
Co-authored-by: Maryam <[email protected]>

Author: bors[bot]

.code-samples.meilisearch.yaml

@@ -454,81 +454,6 @@ search_parameter_guide_show_matches_position_1: |-
       "q": "winter feast",
       "showMatchesPosition": true
     }'
-settings_guide_synonyms_1: |-
-  curl \
-    -X PATCH 'http://localhost:7700/indexes/tops/settings' \
-    -H 'Content-Type: application/json' \
-    --data-binary '{
-      "synonyms": {
-        "sweater": ["jumper"],
-        "jumper": ["sweater"]
-      }
-    }'
-settings_guide_stop_words_1: |-
-  curl \
-    -X PATCH 'http://localhost:7700/indexes/movies/settings' \
-    -H 'Content-Type: application/json' \
-    --data-binary '{
-      "stopWords": [
-        "the",
-        "a",
-        "an"
-      ]
-    }'
-settings_guide_ranking_rules_1: |-
-  curl \
-    -X PATCH 'http://localhost:7700/indexes/movies/settings' \
-    -H 'Content-Type: application/json' \
-    --data-binary '{
-      "rankingRules": [
-        "words",
-        "typo",
-        "proximity",
-        "attribute",
-        "sort",
-        "exactness",
-        "release_date:asc",
-        "rank:desc"
-      ]
-    }'
-settings_guide_distinct_1: |-
-  curl \
-    -X PATCH 'http://localhost:7700/indexes/jackets/settings' \
-    -H 'Content-Type: application/json' \
-    --data-binary '{ "distinctAttribute": "product_id" }'
-settings_guide_searchable_1: |-
-  curl \
-    -X PATCH 'http://localhost:7700/indexes/movies/settings' \
-    -H 'Content-Type: application/json' \
-    --data-binary '{
-      "searchableAttributes": [
-        "title",
-        "overview",
-        "genres"
-      ]
-    }'
-settings_guide_displayed_1: |-
-  curl \
-    -X PATCH 'http://localhost:7700/indexes/movies/settings' \
-    -H 'Content-Type: application/json' \
-    --data-binary '{
-      "displayedAttributes": [
-        "title",
-        "overview",
-        "genres",
-        "release_date"
-      ]
-    }'
-settings_guide_sortable_1: |-
-  curl \
-    -X PATCH 'http://localhost:7700/indexes/books/settings' \
-    -H 'Content-Type: application/json' \
-    --data-binary '{
-      "sortableAttributes": [
-        "price",
-        "author"
-      ]
-    }'
 add_movies_json_1: |-
   curl \
     -X POST 'http://localhost:7700/indexes/movies/documents'\
@@ -898,16 +823,6 @@ typo_tolerance_guide_4: |-
         "twoTypos": 10
       }
     }'
-settings_guide_typo_tolerance_1: |-
-  curl \
-    -X PATCH 'http://localhost:7700/indexes/movies/settings/typo-tolerance' \
-    -H 'Content-Type: application/json' \
-    --data-binary '{
-      "minWordSizeForTypos": {
-        "twoTypos": 12
-      },
-      "disableOnAttributes": ["title"]
-    }'
 updating_guide_check_version_new_authorization_header: |-
   curl \
     -X GET 'http://localhost:7700/version' \
@@ -936,13 +851,6 @@ getting_started_typo_tolerance: |-
     --data-binary '{
       "minWordSizeForTypos": { "oneTypo": 4 }
   }'
-settings_guide_pagination_1: |-
-  curl \
-    -X PATCH 'http://localhost:7700/indexes/movies/settings/pagination' \
-    -H 'Content-Type: application/json' \
-    --data-binary '{
-      "maxTotalHits": 50
-    }'
 get_pagination_settings_1: |-
   curl \
     -X GET 'http://localhost:7700/indexes/books/settings/pagination'
@@ -969,13 +877,6 @@ update_faceting_settings_1: |-
 reset_faceting_settings_1: |-
   curl \
     -X DELETE 'http://localhost:7700/indexes/books/settings/faceting'
-settings_guide_faceting_1: |-
-  curl \
-    -X PATCH 'http://localhost:7700/indexes/movies/settings/faceting' \
-    -H 'Content-Type: application/json' \
-    --data-binary '{
-      "maxValuesPerFacet": 5
-    }'
 synonyms_guide_1: |-
   curl \
     -X PUT 'http://localhost:7700/indexes/movies/settings/synonyms' \

.vuepress/public/sample-template.yaml

@@ -68,13 +68,6 @@ search_parameter_guide_retrieve_1: |-
 search_parameter_guide_crop_1: |-
 search_parameter_guide_highlight_1: |-
 search_parameter_guide_show_matches_position_1: |-
-settings_guide_synonyms_1: |-
-settings_guide_stop_words_1: |-
-settings_guide_ranking_rules_1: |-
-settings_guide_distinct_1: |-
-settings_guide_searchable_1: |-
-settings_guide_displayed_1: |-
-settings_guide_sortable_1: |-
 getting_started_add_documents_md: |-
 getting_started_search_md: |-
 getting_started_check_task_status: |-
@@ -133,21 +126,18 @@ typo_tolerance_guide_1: |-
 typo_tolerance_guide_2: |-
 typo_tolerance_guide_3: |-
 typo_tolerance_guide_4: |-
-settings_guide_typo_tolerance_1: |-
 updating_guide_check_version_new_authorization_header: |-
 updating_guide_check_version_old_authorization_header: |-
 updating_guide_get_displayed_attributes_new: |-
 updating_guide_reset_displayed_attributes_new: |-
 updating_guide_create_dump: |-
 getting_started_typo_tolerance: |-
-settings_guide_pagination_1: |-
 get_pagination_settings_1: |-
 update_pagination_settings_1: |-
 reset_pagination_settings_1: |-
 get_faceting_settings_1: |-
 update_faceting_settings_1: |-
 reset_faceting_settings_1: |-
-settings_guide_faceting_1: |-
 synonyms_guide_1: |-
 getting_started_faceting: |-
 getting_started_pagination: |-

learn/advanced/filtering_and_faceted_search.md

@@ -276,7 +276,7 @@ Please note that **synonyms don't apply to filters.** Meaning, if you have `SF`
 
 #### Example
 
-Suppose you have added `director` and `genres` to the [`filterableAttributes` list](/learn/configuration/settings.md#filterable-attributes), and you want to get movies classified as either `Horror` **or** `Mystery` **and** directed by `Jordan Peele`.
+Suppose you have added `director` and `genres` to the [`filterableAttributes` list](/reference/api/settings.md#filterable-attributes), and you want to get movies classified as either `Horror` **or** `Mystery` **and** directed by `Jordan Peele`.
 
 ```SQL
 [["genres = horror", "genres = mystery"], "director = 'Jordan Peele'"]

learn/advanced/indexing.md

@@ -57,7 +57,7 @@ If you encounter performance issues during indexing, we recommend trying the fol
 ]
 ```
 
-- When creating a new index, first [configure its settings](/learn/configuration/settings.md) and only then add your documents. Following this order will significantly reduce indexing time.
+- When creating a new index, first [configure its settings](/reference/api/settings.md) and only then add your documents. Following this order will significantly reduce indexing time.
 
 - Since indexing speed is tightly connected to the size of your payload, using lightweight dataset formats such as CSV and NDJSON can lead to increased performance.