Comment out extra example fields

Author: lcawl

specification/indices/add_block/IndicesAddBlockResponseExample1.yaml

@@ -1,7 +1,7 @@
-summary: A successful response for adding an index block to an index.
-description: ''
-type: response
-response_code: 200
+# summary: ''
+description: 'A successful response for adding an index block to an index.'
+# type: response
+# response_code: 200
 value:
   "{\n  \"acknowledged\" : true,\n  \"shards_acknowledged\" : true,\n  \"indices\"\
   \ : [ {\n    \"name\" : \"my-index-000001\",\n    \"blocked\" : true\n  } ]\n}"

specification/indices/analyze/indicesAnalyzeRequestExample1.yaml

@@ -1,5 +1,5 @@
 summary: Perform analysis on a text string and returns the resulting tokens.
 method_request: GET /_analyze
-description: ''
-type: request
+# description: ''
+# type: request
 value: "{\n  \"analyzer\" : \"standard\",\n  \"text\" : \"Quick Brown Foxes!\"\n}"

specification/indices/clone/indicesCloneRequestExample1.yaml

@@ -1,7 +1,8 @@
 summary: Clone an existing index.
-method_request: POST /my_source_index/_clone/my_target_index
-description: 'The API accepts `settings` and `aliases` parameters for the target index.'
-type: request
+# method_request: POST /my_source_index/_clone/my_target_index
+description: >
+  Clone `my_source_index` into a new index called `my_target_index` with `POST /my_source_index/_clone/my_target_index`. The API accepts `settings` and `aliases` parameters for the target index.
+# type: request
 value:
   "{\n  \"settings\": {\n    \"index.number_of_shards\": 5\n  },\n  \"aliases\"\
   : {\n    \"my_search_indices\": {}\n  }\n}"

specification/indices/close/indicesCloseResponseExample1.yaml

@@ -1,7 +1,7 @@
-summary: A successful response for closing an index.
-description: ''
-type: response
-response_code: 200
+# summary: ''
+description: A successful response for closing an index.
+# type: response
+# response_code: 200
 value:
   "{\n  \"acknowledged\": true,\n  \"shards_acknowledged\": true,\n  \"indices\"\
   : {\n    \"my-index-000001\": {\n      \"closed\": true\n    }\n  }\n}"

specification/indices/create/indicesCreateRequestExample1.yaml

@@ -1,7 +1,7 @@
 summary: Creates an index.
-method_request: PUT /my-index-000001
+# method_request: PUT /my-index-000001
 description: This request specifies the `number_of_shards` and `number_of_replicas`.
-type: request
+# type: request
 value:
   "{\n  \"settings\": {\n    \"number_of_shards\": 3,\n    \"number_of_replicas\"\
   : 2\n  }\n}"

specification/indices/create/indicesCreateRequestExample2.yaml

@@ -1,7 +1,7 @@
 summary: Creates an index with mapping.
-method_request: PUT /test
+# method_request: PUT /test
 description: You can provide mapping definitions in the create index API requests.
-type: request
+# type: request
 value:
   "{\n  \"settings\": {\n    \"number_of_shards\": 1\n  },\n  \"mappings\": {\n\
   \    \"properties\": {\n      \"field1\": { \"type\": \"text\" }\n    }\n  }\n}"

specification/indices/data_streams_stats/indicesDataStreamStatsResponseExample1.yaml

@@ -1,7 +1,7 @@
-summary: A successful response for retrieving statistics for a data stream.
-description: ''
-type: response
-response_code: 200
+# summary: ''
+description: A successful response for retrieving statistics for a data stream.
+# type: response
+# response_code: 200
 value:
   "{\n  \"_shards\": {\n    \"total\": 10,\n    \"successful\": 5,\n    \"failed\"\
   : 0\n  },\n  \"data_stream_count\": 2,\n  \"backing_indices\": 5,\n  \"total_store_size\"\

specification/indices/delete_data_lifecycle/IndicesDeleteDataLifecycleResponseExample1.yaml

@@ -1,5 +1,5 @@
-summary: A successful response for deleting a data stream lifecycle.
-description: ''
-type: response
-response_code: 200
+# summary: ''
+description: A successful response for deleting a data stream lifecycle.
+# type: response
+# response_code: 200
 value: "{\n  \"acknowledged\": true\n}"

specification/indices/explain_data_lifecycle/IndicesExplainDataLifecycleResponseExample1.yaml

@@ -1,7 +1,7 @@
-summary: A successful response for retrieving data stream lifecycle status for a data stream backing index.
-description: ''
-type: response
-response_code: 200
+# summary: ''
+description: A successful response for retrieving data stream lifecycle status for a data stream backing index.
+# type: response
+# response_code: 200
 value:
   "{\n  \"indices\": {\n    \".ds-metrics-2023.03.22-000001\": {\n      \"index\"\
   \ : \".ds-metrics-2023.03.22-000001\",\n      \"managed_by_lifecycle\" : true,\n\

specification/indices/get_data_lifecycle/IndicesGetDataLifecycleResponseExample1.yaml

@@ -1,7 +1,7 @@
-summary: A successful response of getting the lifecycle of a set of data streams.
-description: ''
-type: response
-response_code: 200
+# summary: 
+description: A successful response of getting the lifecycle of a set of data streams.
+# type: response
+# response_code: 200
 value:
   "{\n  \"data_streams\": [\n    {\n      \"name\": \"my-data-stream-1\",\n \
   \     \"lifecycle\": {\n        \"enabled\": true,\n        \"data_retention\":\