From aa74c4083e047473ac385753e047e075e8f04890 Mon Sep 17 00:00:00 2001 From: Andrew Miller Date: Fri, 28 Jun 2024 15:10:50 +0100 Subject: Fixed #23790 -- Warned about renaming AppConfig.label in docs/ref/applications.txt. --- docs/ref/applications.txt | 8 ++++++++ 1 file changed, 8 insertions(+) (limited to 'docs') 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". -- cgit v1.3