summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/signals.txt9
1 files changed, 9 insertions, 0 deletions
diff --git a/docs/ref/signals.txt b/docs/ref/signals.txt
index d1f5f3c78f..b41b3f63dd 100644
--- a/docs/ref/signals.txt
+++ b/docs/ref/signals.txt
@@ -509,6 +509,15 @@ For example, you could register a callback in an
def ready(self):
post_migrate.connect(my_callback, sender=self)
+.. note::
+
+ If you provide an :class:`~django.apps.AppConfig` instance as the sender
+ argument, please ensure that the signal is registered in
+ :meth:`~django.apps.AppConfig.ready`. ``AppConfig``\s are recreated for
+ tests that run with a modified set of :setting:`INSTALLED_APPS` (such as
+ when settings are overridden) and such signals should be connected for each
+ new ``AppConfig`` instance.
+
post_syncdb
-----------