[1.10.x] Fixed #26787 -- Documented deleting and reloading of model instance fields.

Thanks Julien Hartmann for the report.

Backport of 20d1cb33c2ec1242e16c49deb88e8c70517b2d1a from master

1 files changed, 12 insertions, 0 deletions

diff --git a/docs/ref/models/instances.txt b/docs/ref/models/instances.txt
index 517c29e867..101e1d94a0 100644
--- a/docs/ref/models/instances.txt
+++ b/docs/ref/models/instances.txt
@@ -128,6 +128,18 @@ in the ``from_db()`` method.
 Refreshing objects from database
 ================================
 
+If you delete a field from a model instance, accessing it again reloads the
+value from the database::
+
+    >>> obj = MyModel.objects.first()
+    >>> del obj.field
+    >>> obj.field  # Loads the field from the database
+
+.. versionchanged:: 1.10
+
+    In older versions, accessing a deleted field raised ``AttributeError``
+    instead of reloading it.
+
 .. method:: Model.refresh_from_db(using=None, fields=None)
 
 If you need to reload a model's values from the database, you can use the