diff --git a/docs/reference/cat/indices.asciidoc b/docs/reference/cat/indices.asciidoc
index d63e55a8865..3e8938faab7 100644
--- a/docs/reference/cat/indices.asciidoc
+++ b/docs/reference/cat/indices.asciidoc
@@ -13,8 +13,9 @@ green  open   twitter2   2   0       2030            0      5.8mb          5.8mb
 --------------------------------------------------
 
 We can tell quickly how many shards make up an index, the number of
-docs, deleted docs, primary store size, and total store size (all
-shards including replicas).
+docs at the Lucene level, including hidden docs (e.g., from nested types), 
+deleted docs, primary store size, and total store size (all shards including replicas). 
+All these exposed metrics come directly from Lucene APIs.
 
 [float]
 [[pri-flag]]
diff --git a/docs/reference/cat/segments.asciidoc b/docs/reference/cat/segments.asciidoc
index f4ac6a4a22a..84456e3a313 100644
--- a/docs/reference/cat/segments.asciidoc
+++ b/docs/reference/cat/segments.asciidoc
@@ -44,6 +44,8 @@ generation::    The generation number is incremented with each segment that is w
                 The name of the segment is derived from this generation number.
 
 docs.count::    The number of non-deleted documents that are stored in this segment.
+                Note that these are Lucene documents, so the count will include hidden
+				documents (e.g. from nested types).
 
 docs.deleted::  The number of deleted documents that are stored in this segment.
                 It is perfectly fine if this number is greater than 0, space is