From 1ac2f25ec091847a2db313210eb9743ed3b0dabf Mon Sep 17 00:00:00 2001
From: David Vaz <davidmgvaz@gmail.com>
Date: Fri, 27 Sep 2019 09:41:49 -0700
Subject: [PATCH] [2.2.x] Refs #30597 -- Added a warning about dependent apps
 when unapplying migrations.

Backport of abba563c8635a52e8b657dee7708202e1f69433c from master
---
 docs/ref/django-admin.txt | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/ref/django-admin.txt b/docs/ref/django-admin.txt
index c2094e962b..8590739fed 100644
--- a/docs/ref/django-admin.txt
+++ b/docs/ref/django-admin.txt
@@ -804,6 +804,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``.