summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/applications.txt9
1 files changed, 9 insertions, 0 deletions
diff --git a/docs/ref/applications.txt b/docs/ref/applications.txt
index 60db009585..8ecf47546b 100644
--- a/docs/ref/applications.txt
+++ b/docs/ref/applications.txt
@@ -99,6 +99,15 @@ to determine which application this configuration applies to. You can define
any attributes documented in the :class:`~django.apps.AppConfig` API
reference.
+.. note::
+
+ If your code imports the application registry in an application's
+ ``__init__.py``, the name ``apps`` will clash with the ``apps`` submodule.
+ The best practice is to move that code to a submodule and import it. A
+ workaround is to import the registry under a different name::
+
+ from django.apps import apps as django_apps
+
For application users
---------------------