Apply suggestions from code review

Co-authored-by: Marci W <333176+marciw@users.noreply.github.com>

Author: pquentin

docs/release-notes/breaking-changes.md

@@ -29,23 +29,23 @@ For more information, check [PR #2840](https://github.com/elastic/elasticsearch-
  * `maxsize` is now `connection_per_node`
 ::::
 
-::::{dropdown} Remove deprecated `url_prefix` and `use_ssl` host keys
+::::{dropdown} Remove deprecated url_prefix and use_ssl host keys
 When instantiating a new client, `hosts` can be specified as a dictionary. The `url_prefix` and `use_ssl` keys are no longer allowed.
 For more information, check [PR #2797](https://github.com/elastic/elasticsearch-py/pull/2797).
 
 **Impact**<br>
-Using any of those parameters will prevent instantiating the Elasticsearch client.
+Using any of these parameters will prevent instantiating the Elasticsearch client.
 
 **Action**<br>
 The parameters can be replaced as follows:
- * `use_ssl` isn't needed as a scheme is required since elasticsearch-py 8.0 (`http` or `https`)
- * `url_prefix` should be replaced with `path_prefix`, which is more descriptive. Indeed, this functionality allows deploying Elasticsearch under a specific path, such as `http://host:port/path/to/elasticsearch`, instead of the default root path (`http://host:port/`)
+ * `use_ssl` isn't needed, as a scheme is required since elasticsearch-py 8.0 (`http` or `https`)
+ * `url_prefix` should be replaced with `path_prefix`, which is more descriptive. This functionality allows you to deploy Elasticsearch under a specific path, such as `http://host:port/path/to/elasticsearch`, instead of the default root path (`http://host:port/`)
 ::::
 
-::::{dropdown} Removed APIs
+::::{dropdown} Remove APIs
 Elasticsearch 9 removed the kNN search and Unfreeze index APIs.
 
 **Action**<br>
  * The kNN search API has been replaced by the `knn` option in the search API since Elasticsearch 8.4.
- * The Unfreeze index API was deprecated in Elasticsearch 7.14, and has been removed in Elasticsearch 9 since it is not possible to freeze an index since Elasticsearch 8.0.
+ * The Unfreeze index API was deprecated in Elasticsearch 7.14 and has been removed in Elasticsearch 9.
  ::::

docs/release-notes/index.md

@@ -35,21 +35,21 @@ See the [breaking changes page](breaking-changes.md) for more details.
 
 ### Enhancements
 
-* Merge `Elasticsearch-DSL <https://github.com/elastic/elasticsearch-dsl-py/>`_ package ([#2736](https://github.com/elastic/elasticsearch-py/pull/2736))
+* Merge [`elasticsearch-dsl-py`](https://github.com/elastic/elasticsearch-dsl-py/) _ package ([#2736](https://github.com/elastic/elasticsearch-py/pull/2736))
 * Add Python DSL documentation ([#2761](https://github.com/elastic/elasticsearch-py/pull/2761))
 * Autogenerate DSL field classes from schema ([#2780](https://github.com/elastic/elasticsearch-py/pull/2780))
 * Improve DSL documentation examples with class-based queries and type hints ([#2857](https://github.com/elastic/elasticsearch-py/pull/2857))
 * Document the use of `param()` in Python DSL methods ([#2861](https://github.com/elastic/elasticsearch-py/pull/2861))
 * Migrate documentation from AsciiDoc to Markdown format ([#2806](https://github.com/elastic/elasticsearch-py/pull/2806))
 * Document use of sub-clients ([#2798](https://github.com/elastic/elasticsearch-py/pull/2798))
-* Document how to making API calls ([#2843](https://github.com/elastic/elasticsearch-py/pull/2843))
+* Document how to make API calls ([#2843](https://github.com/elastic/elasticsearch-py/pull/2843))
 * Fix `simulate` sub-client documentation ([#2749](https://github.com/elastic/elasticsearch-py/pull/2749))
 
 ### APIs
 
 * Remove deprecated `/_knn_search` API
 * Remove Unfreeze an index API
-* Remove min_compatible_shard_node from Search and Async Search Submit APIs
+* Remove `min_compatible_shard_node` from Search and Async Search Submit APIs
 * Remove local parameter from cat alias, Alias exists, and Get alias APIs
 * Remove `verbose` from Index segments API
 * Remove `include_model_definition` from Get trained model configuration info API
@@ -61,15 +61,16 @@ See the [breaking changes page](breaking-changes.md) for more details.
 * Add `master_timeout` to the Alias exists and Get alias APIs.
 * Add `expand_wildcards` to Create snapshot API
 * Rename incorrect `access_token` to `token` in Logout of OpenID Connect API
-* Add inference APIs: Alibaba Cloud AI Search, Amazon Bedrock, Anthropic, Azure AI Studio,Azure OpenAI, Cohere, Elastic Inference Service (EIS), Elasticsearch, ELSER, Google AIStudio, Google Vertex AI, Hugging Face, Jina AI, Mistral, OpenAI, and Voyage AI
+* Add inference APIs: Alibaba Cloud AI Search, Amazon Bedrock, Anthropic, Azure AI Studio, Azure OpenAI, Cohere, Elastic Inference Service (EIS), Elasticsearch, ELSER, Google AI Studio, Google Vertex AI, Hugging Face, Jina AI, Mistral, OpenAI, and Voyage AI
 * Add Elastic Inference Service (EIS) chat completion API
 * Add Reindex legacy backing indices APIs
 * Add Create an index from a source index API
 * Add `include_source_on_error` to Create, Index, Update and Bulk APIs
 * Add Stop async ES|QL query API
 * Add `timeout` to Resolve Cluster API
 * Add `adaptive_allocations` body field to Start and Update a trained model deployment API
-* Rename `index_template_subtitutions` to `index_template_substitutions` in Simulate dataingestion API* Add `if_primary_term`, `if_seq_no`, `op_type`, `require_alias` and `require_data_stream` to Create API
+* Rename `index_template_subtitutions` to `index_template_substitutions` in Simulate data ingestion API
+* Add `if_primary_term`, `if_seq_no`, `op_type`, `require_alias` and `require_data_stream` to Create API
 * Add `max_concurrent_shard_requests` to Open point in time API
 * Add `local` and `flat_settings` to Check index templates API
 * Add `reopen` to Update index settings API