diff --git a/spec/namespaces/cluster.yaml b/spec/namespaces/cluster.yaml
index b99b49203..eb6d673f6 100644
--- a/spec/namespaces/cluster.yaml
+++ b/spec/namespaces/cluster.yaml
@@ -961,7 +961,7 @@ components:
     cluster.health::path.index:
       in: path
       name: index
-      description: Comma-separated list of data streams, indices, and index aliases used to limit the request. Wildcard expressions (*) are supported. To target all data streams and indices in a cluster, omit this parameter or use _all or *.
+      description: Comma-separated list of data streams, indices, and index aliases used to limit the request. Wildcard expressions (*) are supported. To target all data streams and indices in a cluster, omit this parameter or use `_all` or `*`.
       required: true
       schema:
         $ref: '../schemas/_common.yaml#/components/schemas/Indices'
diff --git a/spec/namespaces/indices.yaml b/spec/namespaces/indices.yaml
index d5f3824f6..569fabd16 100644
--- a/spec/namespaces/indices.yaml
+++ b/spec/namespaces/indices.yaml
@@ -4261,7 +4261,7 @@ components:
     indices.put_settings::query.ignore_unavailable:
       in: query
       name: ignore_unavailable
-      description: If `true`, returns settings in flat format.
+      description: Whether specified concrete indices should be ignored when unavailable (missing or closed).
       schema:
         type: boolean
       style: form