diff --git a/docs/topics/migrations.txt b/docs/topics/migrations.txt
index 0e1aaa7642..2be05903ae 100644
--- a/docs/topics/migrations.txt
+++ b/docs/topics/migrations.txt
@@ -582,8 +582,8 @@ Once the operation sequence has been reduced as much as possible - the amount
 possible depends on how closely intertwined your models are and if you have
 any :class:`~django.db.migrations.operations.RunSQL`
 or :class:`~django.db.migrations.operations.RunPython` operations (which can't
-be optimized through) - Django will then write it back out into a new set of
-migration files.
+be optimized through unless they are marked as ``elidable``) - Django will then
+write it back out into a new set of migration files.
 
 These files are marked to say they replace the previously-squashed migrations,
 so they can coexist with the old migration files, and Django will intelligently