From fa3ae446d938455b47fc978cdfecb956b1238812 Mon Sep 17 00:00:00 2001
From: Mariusz Felisiak <felisiak.mariusz@gmail.com>
Date: Fri, 19 Jul 2019 13:02:57 +0200
Subject: [PATCH] [2.2.x] Refs #30083 -- Clarified database state of instances
 in signals.pre_init docs.

Backport of a2e1c17f193f5017e1f6fac7d860f1f9e34d7892 from master
---
 docs/ref/signals.txt | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/ref/signals.txt b/docs/ref/signals.txt
index f2f0ab4257..a89560cc1e 100644
--- 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``
 ------------