Ticket #3997: 3997_2.diff

docs/model-api.txt

@@ -79 +79 @@
         release_date = models.DateField()
         num_stars = models.IntegerField()
 
+.. note::
+    Unless otherwise specified (``null`` or ``default`` attributes) ALL fields 
+    are required to be set in an instance. Any missing field will cause 
+    ``save()`` to raise exceptions (backend-dependent, for example sqlite will 
+    raise ``IntegrityError`` while mysql would raise ``OperationalError``).
+
 Field name restrictions
 -----------------------