diff --git a/specification/cat/indices/types.ts b/specification/cat/indices/types.ts
index c47cdc13ad..1052825ebd 100644
--- a/specification/cat/indices/types.ts
+++ b/specification/cat/indices/types.ts
@@ -55,7 +55,11 @@ export class IndicesRecord {
   'rep'?: string
 
   /**
-   * available docs
+   * The number of documents in the index, including hidden nested documents.
+   * For indices with `semantic_text` fields or other nested field types, this count
+   * includes the internal nested documents.
+   * To get the logical document count (excluding nested documents), use the `_count`
+   * API or `_cat/count` API instead.
    * @aliases dc,docsCount
    */
   'docs.count'?: string | null