From 5d40de08566cc7f0987ea414e06f37e6ed4e019a Mon Sep 17 00:00:00 2001
From: David Vaz <davidmgvaz@gmail.com>
Date: Fri, 27 Sep 2019 09:41:49 -0700
Subject: [3.0.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(+)

(limited to 'docs/ref')

diff --git a/docs/ref/django-admin.txt b/docs/ref/django-admin.txt
index eaba4d437d..34cb806db1 100644
--- 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``.
-- 
cgit v1.3