Fixed #19746 -- Allow deserialization of pk-less data

1 files changed, 10 insertions, 0 deletions

diff --git a/docs/topics/serialization.txt b/docs/topics/serialization.txt
index 2af0584a61..982f986aad 100644
--- a/docs/topics/serialization.txt
+++ b/docs/topics/serialization.txt
@@ -117,6 +117,16 @@ object and any associated relationship data.
 
 Calling ``DeserializedObject.save()`` saves the object to the database.
 
+.. note::
+
+    If the ``pk`` attribute in the serialized data doesn't exist or is
+    null, a new instance will be saved to the database.
+
+.. versionchanged:: 1.6
+
+In previous versions of Django, the ``pk`` attribute had to be present
+on the serialized data or a ``DeserializationError`` would be raised.
+
 This ensures that deserializing is a non-destructive operation even if the
 data in your serialized representation doesn't match what's currently in the
 database. Usually, working with these ``DeserializedObject`` instances looks