[2.2.x] Refs #30083 -- Clarified database state of instances in signals.pre_init docs.

Backport of a2e1c17f19 from master
2019-07-19 13:02:57 +02:00 · 2019-07-19 13:02:57 +02:00 · fa3ae446d9
parent de2635fb4e
commit fa3ae446d9
1 changed files with 7 additions and 0 deletions
--- a/docs/ref/signals.txt
+++ b/docs/ref/signals.txt
@ -99,6 +99,13 @@ Arguments sent with this signal:
 ``instance``
    The actual instance of the model that's just been created.

+    .. note::
+
+        ``instance._state`` isn't set before sending the ``post_init`` signal,
+        so ``_state`` attributes always have their default values. For example,
+        ``_state.db`` is ``None`` and cannot be used to check an ``instance``
+        database.
+
 ``pre_save``
 ------------