diff --git a/lucene/CHANGES.txt b/lucene/CHANGES.txt
index 9e2562c2acd..f5357c682b4 100644
--- a/lucene/CHANGES.txt
+++ b/lucene/CHANGES.txt
@@ -69,6 +69,10 @@ API Changes
   inner Reader is 'input' like CharFilter in the 3.x series, instead of 'in'.  
   (Dawid Weiss, Uwe Schindler, Robert Muir)
 
+* LUCENE-3309: The expert FieldSelector API, used to load only certain
+  fields in a stored document, has been replaced with the simpler
+  StoredFieldVisitor API.  (Mike McCandless)
+
 Bug Fixes
 
 * LUCENE-4297: BooleanScorer2 would multiply the coord() factor
diff --git a/lucene/MIGRATE.txt b/lucene/MIGRATE.txt
index 68a9b96b703..352bb71ddd3 100644
--- a/lucene/MIGRATE.txt
+++ b/lucene/MIGRATE.txt
@@ -619,3 +619,10 @@ you can now do this:
   postings in simple arrrays (byte[] for terms, int[] for docs, freqs,
   positions, offsets).  Note that this only covers postings, whereas
   Instantiated covered all other parts of the index as well.
+
+* LUCENE-3309: The expert FieldSelector API has been replaced with
+  StoredFieldVisitor.  The idea is the same (you have full control
+  over which fields should be loaded).  Instead of a single accept
+  method, StoredFieldVisitor has a needsField method: if that method
+  returns true then the field will be loaded and the appropriate
+  type-specific method will be invoked with that fields's value.