[3.0.x] Refs #30597 -- Added a warning about dependent apps when unap…

…plying migrations. Backport of abba563 from master
django · Sep 27, 2019 · 5d40de0 · 5d40de0
1 parent 0dc39ca
commit 5d40de0
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/docs/ref/django-admin.txt b/docs/ref/django-admin.txt
@@ -813,6 +813,12 @@ The behavior of this command changes depending on the arguments provided:
   migrated past the named migration. Use the name ``zero`` to unapply all
   migrations for an app.
 
+.. warning::
+
+    When unapplying migrations, all dependent migrations will also be
+    unapplied, regardless of ``<app_label>``. You can use ``--plan`` to check
+    which migrations will be unapplied.
+
 .. django-admin-option:: --database DATABASE
 
 Specifies the database to migrate. Defaults to ``default``.