diff --git a/docs/ref/applications.txt b/docs/ref/applications.txt index 23409515421..0811bdf75fb 100644 --- a/docs/ref/applications.txt +++ b/docs/ref/applications.txt @@ -347,6 +347,8 @@ Application registry :exc:`ValueError` when called with a single argument that doesn't contain exactly one dot. +.. _app-loading-process: + Initialization process ====================== @@ -425,9 +427,9 @@ Troubleshooting Here are some common problems that you may encounter during initialization: -* ``AppRegistryNotReady`` This happens when importing an application - configuration or a models module triggers code that depends on the app - registry. +* :class:`~django.core.exceptions.AppRegistryNotReady`: This happens when + importing an application configuration or a models module triggers code that + depends on the app registry. For example, :func:`~django.utils.translation.ugettext()` uses the app registry to look up translation catalogs in applications. To translate at diff --git a/docs/ref/exceptions.txt b/docs/ref/exceptions.txt index 8c05aca9770..6ce52977e81 100644 --- a/docs/ref/exceptions.txt +++ b/docs/ref/exceptions.txt @@ -12,6 +12,15 @@ Django Core Exceptions Django core exception classes are defined in ``django.core.exceptions``. +``AppRegistryNotReady`` +----------------------- + +.. exception:: AppRegistryNotReady + + This exception is raised when attempting to use models before the :ref:`app + loading process `, which initializes the ORM, is + complete. + ``ObjectDoesNotExist`` ----------------------