From ad191d9e011f37d79a7f2df3da881b06539aaaea Mon Sep 17 00:00:00 2001
From: Rodrigo <matematica.a3k@gmail.com>
Date: Mon, 3 Dec 2018 21:37:28 -0500
Subject: [PATCH] Fixed #29895 -- Doc'd why MySQL's atomic DDL statements don't
 work for atomic migrations.

---
 docs/howto/writing-migrations.txt | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/howto/writing-migrations.txt b/docs/howto/writing-migrations.txt
index f98a56c534b..084513b312a 100644
--- a/docs/howto/writing-migrations.txt
+++ b/docs/howto/writing-migrations.txt
@@ -221,7 +221,10 @@ smaller batches::
         ]
 
 The ``atomic`` attribute doesn't have an effect on databases that don't support
-DDL transactions (e.g. MySQL, Oracle).
+DDL transactions (e.g. MySQL, Oracle). (MySQL's `atomic DDL statement support
+<https://dev.mysql.com/doc/refman/en/atomic-ddl.html>`_ refers to individual
+statements rather than multiple statements wrapped in a transaction that can be
+rolled back.)
 
 Controlling the order of migrations
 ===================================