[1.8.x] Fixed #22571 -- Added clarification about auto_now_add=True

Backport of cbe4efcbc13ad402bf1f1a94b02a8ec93f20327d from master

1 files changed, 5 insertions, 1 deletions

diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt
index ae3d4bb441..5893a57464 100644
--- a/docs/ref/models/fields.txt
+++ b/docs/ref/models/fields.txt
@@ -495,7 +495,11 @@ optional arguments:
 
     Automatically set the field to now when the object is first created. Useful
     for creation of timestamps. Note that the current date is *always* used;
-    it's not just a default value that you can override.
+    it's not just a default value that you can override. So even if you
+    set a value for this field when creating the object, it will be ignored.
+    If you want to be able to modify this field, set ``default=timezone.now``
+    (from :func:`django.utils.timezone.now`) instead of ``auto_now_add=True``.
+
 
 The default form widget for this field is a
 :class:`~django.forms.TextInput`. The admin adds a JavaScript calendar,