diff --git a/lib/ecto/migration.ex b/lib/ecto/migration.ex
index 7ddc64f6..c1f28e1c 100644
--- a/lib/ecto/migration.ex
+++ b/lib/ecto/migration.ex
@@ -1549,7 +1549,11 @@ defmodule Ecto.Migration do
     struct!(%Constraint{table: table, name: name}, opts)
   end
 
-  @doc "Executes queue migration commands."
+  @doc """
+  Execute all changes specified by the migration so far.
+
+  See [Executing and flushing](#module-executing-and-flushing).
+  """
   defmacro flush do
     quote do
       if direction() == :down and not function_exported?(__MODULE__, :down, 0) do