summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorAndrew Miller <info@akmiller.co.uk>2024-06-28 15:10:50 +0100
committernessita <124304+nessita@users.noreply.github.com>2024-07-01 21:52:04 -0300
commitaa74c4083e047473ac385753e047e075e8f04890 (patch)
treec11b7f6c4cf8714a359d8e12cc9d7a8245c4672c /docs
parent289f48c71b0fdd058defb29879368897fb837021 (diff)
Fixed #23790 -- Warned about renaming AppConfig.label in docs/ref/applications.txt.
Diffstat (limited to 'docs')
-rw-r--r--docs/ref/applications.txt8
1 files changed, 8 insertions, 0 deletions
diff --git a/docs/ref/applications.txt b/docs/ref/applications.txt
index 69d04380ce..eecaa9e323 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".