Updated advice on connecting signals at startup.

1 files changed, 6 insertions, 0 deletions

diff --git a/docs/ref/signals.txt b/docs/ref/signals.txt
index ece6990aa7..2e9f6ccea6 100644
--- a/docs/ref/signals.txt
+++ b/docs/ref/signals.txt
@@ -354,6 +354,12 @@ Sent whenever a model class has been "prepared" -- that is, once model has
 been defined and registered with Django's model system. Django uses this
 signal internally; it's not generally used in third-party applications.
 
+Since this signal is sent during the app registry population process, and
+:meth:`AppConfig.setup() <django.apps.AppConfig.setup>` runs after the app
+registry is fully populated, receivers cannot be connected in that method.
+One possibility is to connect them ``AppConfig.__init__()`` instead, taking
+care not to import models or trigger calls to the app registry.
+
 Arguments that are sent with this signal:
 
 ``sender``