Touch up on the config template (#21879)

* style touch up

* changelog

Author: steveny91

elastic/assets/configuration/spec.yaml

@@ -11,7 +11,7 @@ files:
     - name: url
       required: true
       description: |
-        The URL where elasticsearch accepts HTTP requests. This is used to
+        The URL where Elasticsearch accepts HTTP requests. This is used to
         fetch statistics from the nodes and information about the cluster health.
       value:
         example: http://localhost:9200
@@ -27,8 +27,8 @@ files:
         example: false
     - name: cluster_stats
       description: |
-        If your cluster is hosted externally (i.e., you're not pointing to localhost)
-        you must to set `cluster_stats` to true otherwise the check only
+        If your cluster is hosted externally (i.e., you're not pointing to localhost),
+        you must set `cluster_stats` to true, otherwise the check only
         submits metrics of the local node.
         This parameter was also called `is_external` and you can still use it but it
         is removed in Agent version 6+.
@@ -44,39 +44,39 @@ files:
         type: boolean
         example: false
     - name: index_stats
-      description: Set "index_stats" to true to collect metrics for individual indices.
+      description: Set `index_stats` to true to collect metrics for individual indices.
       value:
         type: boolean
         example: false
     - name: pshard_stats
       description: |
-        If you enable the "pshard_stats" flag, statistics over primary shards
+        If you enable the `pshard_stats` flag, statistics over primary shards
         are collected by the check and sent to the backend with the
-        'elasticsearch.primary' prefix. It is particularly useful if you want to
+        `elasticsearch.primary` prefix. It is particularly useful if you want to
         get certain metrics without taking replicas into account. For instance,
-        'elasticsearch.primaries.docs.count` gives you the total number of
+        `elasticsearch.primaries.docs.count` gives you the total number of
         documents in your indexes WITHOUT counting duplicates due to the existence
         of replica shards in your ES cluster.
       value:
         type: boolean
         example: false
     - name: slm_stats
       description: |
-        Set "slm_stats" to true to collect statistics about Snapshot Lifcycle Management.
+        Set `slm_stats` to true to collect statistics about Snapshot Lifecycle Management.
         The user must have the `read_slm` cluster privilege to get these metrics.
       value:
         type: boolean
         example: false
     - name: pshard_graceful_timeout
-      description: Continue gracefully if pshard stats TO
+      description: Continue gracefully if pshard stats timeout.
       value:
         type: boolean
         example: false
     - name: pending_task_stats
       description: |
-        It specifies whether to collect data exposed by the `pending_tasks` cluster endpoint.
+        Specifies whether to collect data exposed by the `pending_tasks` cluster endpoint.
         Ref: https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-pending.html
-        Some managed ElasticSearch services (e.g. AWS ElasticSearch) do not expose this endpoint.
+        Some managed Elasticsearch services (e.g., AWS Elasticsearch) do not expose this endpoint.
         Set `pending_task_stats` to false if you use such a service.
       value:
         type: boolean
@@ -90,8 +90,8 @@ files:
         example: false
     - name: admin_forwarder
       description: |
-        It is used to signify a URL that includes a context root
-        needed for a forwarder application to access Elasticsearch REST services for example
+        Specifies a URL that includes a context root
+        needed for a forwarder application to access Elasticsearch REST services, for example:
         https://www.ibm.com/support/knowledgecenter/SSFTN5_8.5.6/com.ibm.wbpm.main.doc/topics/tadm_fps_esearch.html
       value:
         type: boolean
@@ -112,7 +112,7 @@ files:
       enabled: false
     - name: disable_legacy_service_check_tags
       description: |
-        Disable the submission of the elasticsearch `host` and `port` as tags in service checks. 
+        Disable the submission of the Elasticsearch `host` and `port` as tags in service checks.
         Submit them as `url` instead.
       value:
         type: boolean
@@ -141,7 +141,7 @@ files:
                               breaker, the `value_path` is `estimated_size_in_bytes`.
               2. name - The full metric name sent to Datadog. If `type` is `tag`, this column is considered a tag and
                         applied to every metric collected by this particular query.
-              3. type (optional) - An optional parameter to designates the type of data sent. Possible values for
+              3. type (optional) - An optional parameter to designate the type of data sent. Possible values for
                                    `type` include `gauge`, `monotonic_count`, `rate`, and `tag`, with `gauge` being
                                    the default.
 
@@ -227,7 +227,7 @@ files:
     - name: url
       required: true
       description: |
-        The URL where elasticsearch accepts HTTP requests. This is used to
+        The URL where Elasticsearch accepts HTTP requests. This is used to
         fetch statistics from the nodes and information about the cluster health.
       value:
         example: http://%%host%%:9200

elastic/changelog.d/21879.fixed

@@ -0,0 +1 @@
+Fix styling and grammatical errors in the config template

elastic/datadog_checks/elastic/data/auto_conf.yaml

@@ -16,7 +16,7 @@ init_config:
 instances:
 
     ## @param url - string - required
-    ## The URL where elasticsearch accepts HTTP requests. This is used to
+    ## The URL where Elasticsearch accepts HTTP requests. This is used to
     ## fetch statistics from the nodes and information about the cluster health.
     #
   - url: http://%%host%%:9200

elastic/datadog_checks/elastic/data/conf.yaml.example

@@ -46,7 +46,7 @@ init_config:
 instances:
 
     ## @param url - string - required
-    ## The URL where elasticsearch accepts HTTP requests. This is used to
+    ## The URL where Elasticsearch accepts HTTP requests. This is used to
     ## fetch statistics from the nodes and information about the cluster health.
     #
   - url: http://localhost:9200
@@ -60,8 +60,8 @@ instances:
     # node_name_as_host: false
 
     ## @param cluster_stats - boolean - optional - default: false
-    ## If your cluster is hosted externally (i.e., you're not pointing to localhost)
-    ## you must to set `cluster_stats` to true otherwise the check only
+    ## If your cluster is hosted externally (i.e., you're not pointing to localhost),
+    ## you must set `cluster_stats` to true, otherwise the check only
     ## submits metrics of the local node.
     ## This parameter was also called `is_external` and you can still use it but it
     ## is removed in Agent version 6+.
@@ -76,36 +76,36 @@ instances:
     # detailed_index_stats: false
 
     ## @param index_stats - boolean - optional - default: false
-    ## Set "index_stats" to true to collect metrics for individual indices.
+    ## Set `index_stats` to true to collect metrics for individual indices.
     #
     # index_stats: false
 
     ## @param pshard_stats - boolean - optional - default: false
-    ## If you enable the "pshard_stats" flag, statistics over primary shards
+    ## If you enable the `pshard_stats` flag, statistics over primary shards
     ## are collected by the check and sent to the backend with the
-    ## 'elasticsearch.primary' prefix. It is particularly useful if you want to
+    ## `elasticsearch.primary` prefix. It is particularly useful if you want to
     ## get certain metrics without taking replicas into account. For instance,
-    ## 'elasticsearch.primaries.docs.count` gives you the total number of
+    ## `elasticsearch.primaries.docs.count` gives you the total number of
     ## documents in your indexes WITHOUT counting duplicates due to the existence
     ## of replica shards in your ES cluster.
     #
     # pshard_stats: false
 
     ## @param slm_stats - boolean - optional - default: false
-    ## Set "slm_stats" to true to collect statistics about Snapshot Lifcycle Management.
+    ## Set `slm_stats` to true to collect statistics about Snapshot Lifecycle Management.
     ## The user must have the `read_slm` cluster privilege to get these metrics.
     #
     # slm_stats: false
 
     ## @param pshard_graceful_timeout - boolean - optional - default: false
-    ## Continue gracefully if pshard stats TO
+    ## Continue gracefully if pshard stats timeout.
     #
     # pshard_graceful_timeout: false
 
     ## @param pending_task_stats - boolean - optional - default: true
-    ## It specifies whether to collect data exposed by the `pending_tasks` cluster endpoint.
+    ## Specifies whether to collect data exposed by the `pending_tasks` cluster endpoint.
     ## Ref: https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-pending.html
-    ## Some managed ElasticSearch services (e.g. AWS ElasticSearch) do not expose this endpoint.
+    ## Some managed Elasticsearch services (e.g., AWS Elasticsearch) do not expose this endpoint.
     ## Set `pending_task_stats` to false if you use such a service.
     #
     # pending_task_stats: true
@@ -117,8 +117,8 @@ instances:
     # cat_allocation_stats: false
 
     ## @param admin_forwarder - boolean - optional - default: false
-    ## It is used to signify a URL that includes a context root
-    ## needed for a forwarder application to access Elasticsearch REST services for example
+    ## Specifies a URL that includes a context root
+    ## needed for a forwarder application to access Elasticsearch REST services, for example:
     ## https://www.ibm.com/support/knowledgecenter/SSFTN5_8.5.6/com.ibm.wbpm.main.doc/topics/tadm_fps_esearch.html
     #
     # admin_forwarder: false
@@ -135,7 +135,7 @@ instances:
     # disable_legacy_cluster_tag: true
 
     ## @param disable_legacy_service_check_tags - boolean - optional - default: false
-    ## Disable the submission of the elasticsearch `host` and `port` as tags in service checks. 
+    ## Disable the submission of the Elasticsearch `host` and `port` as tags in service checks.
     ## Submit them as `url` instead.
     #
     disable_legacy_service_check_tags: true
@@ -161,7 +161,7 @@ instances:
     ##                       breaker, the `value_path` is `estimated_size_in_bytes`.
     ##       2. name - The full metric name sent to Datadog. If `type` is `tag`, this column is considered a tag and
     ##                 applied to every metric collected by this particular query.
-    ##       3. type (optional) - An optional parameter to designates the type of data sent. Possible values for
+    ##       3. type (optional) - An optional parameter to designate the type of data sent. Possible values for
     ##                            `type` include `gauge`, `monotonic_count`, `rate`, and `tag`, with `gauge` being
     ##                            the default.
     ##