From aa74c4083e047473ac385753e047e075e8f04890 Mon Sep 17 00:00:00 2001
From: Andrew Miller <info@akmiller.co.uk>
Date: Fri, 28 Jun 2024 15:10:50 +0100
Subject: [PATCH] Fixed #23790 -- Warned about renaming AppConfig.label in
 docs/ref/applications.txt.

---
 AUTHORS                   | 1 +
 docs/ref/applications.txt | 8 ++++++++
 2 files changed, 9 insertions(+)

diff --git a/AUTHORS b/AUTHORS
index ef5054fd1179..6e54cc1ea69d 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -87,6 +87,7 @@ answer newbie questions, and generally made Django that much better:
     Andrew Clark <amclark7@gmail.com>
     Andrew Durdin <adurdin@gmail.com>
     Andrew Godwin <andrew@aeracode.org>
+    Andrew Miller <info+django@akmiller.co.uk>
     Andrew Pinkham <http://AndrewsForge.com>
     Andrews Medina <andrewsmedina@gmail.com>
     Andrew Northall <andrew@northall.me.uk>
diff --git a/docs/ref/applications.txt b/docs/ref/applications.txt
index 69d04380ce25..eecaa9e3232b 100644
--- a/docs/ref/applications.txt
+++ b/docs/ref/applications.txt
@@ -186,6 +186,14 @@ Configurable attributes
 
     It must be unique across a Django project.
 
+    .. warning::
+
+        Changing this attribute after migrations have been applied for an
+        application will result in breaking changes to a project or, in the
+        case of a reusable app, any existing installs of that app. This is
+        because ``AppConfig.label`` is used in database tables and migration
+        files when referencing an app in the dependencies list.
+
 .. attribute:: AppConfig.verbose_name
 
     Human-readable name for the application, e.g. "Administration".