diff --git a/lib/ecto/migration.ex b/lib/ecto/migration.ex
index a10a0700..382ddb75 100644
--- a/lib/ecto/migration.ex
+++ b/lib/ecto/migration.ex
@@ -163,9 +163,9 @@ defmodule Ecto.Migration do
 
   ## Executing and flushing
 
-  Instructions inside of migrations are not executed immediately. Instead
-  they are performed after the relevant `up`, `change`, or `down` callback
-  terminates.
+  Most functions in this module, when executed inside of migrations,
+  are not executed immediately. Instead they are performed after the
+  relevant `up`, `change`, or `down` callback terminates.
 
   However, in some situations you may want to guarantee that all of the
   previous steps have been executed before continuing. This is useful when