diff --git a/lucene/contrib/CHANGES.txt b/lucene/contrib/CHANGES.txt
index 2d2f776e994..1aeba0c32cb 100644
--- a/lucene/contrib/CHANGES.txt
+++ b/lucene/contrib/CHANGES.txt
@@ -64,6 +64,12 @@ New Features
    with three implementations: Jaspell, Ternary Trie, and Finite State.
    (Andrzej Bialecki, Dawid Weiss, Mike Mccandless, Robert Muir)
  
+ * LUCENE-3129: Added BlockGroupingCollector, a single pass
+   grouping collector which is faster than the two-pass approach, and
+   also computes the total group count, but requires that every
+   document sharing the same group was indexed as a doc block
+   (IndexWriter.add/updateDocuments).  (Mike McCandless)
+
 API Changes
 
  * LUCENE-3141: add getter method to access fragInfos in FieldFragList.
@@ -130,12 +136,6 @@ New Features
    case where the indexing rate is lowish but the reopen rate is
    highish, to take load off the IO system.  (Mike McCandless)
 
- * LUCENE-3129: Added BlockGroupingCollector, a single pass
-   grouping collector which is faster than the two-pass approach, and
-   also computes the total group count, but requires that every
-   document sharing the same group was indexed as a doc block
-   (IndexWriter.add/updateDocuments).  (Mike McCandless)
-
 Optimizations
 
  * LUCENE-3040: Switch all analysis consumers (highlighter, morelikethis, memory, ...)
diff --git a/modules/grouping/src/java/org/apache/lucene/search/grouping/package.html b/modules/grouping/src/java/org/apache/lucene/search/grouping/package.html
index fa3b7f0518d..4b2f02a7caa 100644
--- a/modules/grouping/src/java/org/apache/lucene/search/grouping/package.html
+++ b/modules/grouping/src/java/org/apache/lucene/search/grouping/package.html
@@ -89,6 +89,7 @@ But the downside is it's somewhat slower to run, and requires more RAM
 <ul>
   <li> For the two-pass grouping collector, the group field must be a
     single-valued indexed field.
+    {@link org.apache.lucene.search.FieldCache} is used to load the {@link org.apache.lucene.search.FieldCache.DocTermsIndex} for this field.
   <li> Unlike Solr's implementation, this module cannot group by
     function query values nor by arbitrary queries.
   <li> Sharding is not directly supported, though is not too