Field level explanation added

Author: mridula-s109

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 used for storing chunks and embeddings.
+   * 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