From 6de9b7c8caaea00df2b1399ecd7b815ac556a70e Mon Sep 17 00:00:00 2001
From: Tom Christie
Date: Thu, 11 Jul 2013 21:02:47 +0100
Subject: Add note on ModelSerializer validation of both model fields and
 serializer fields. Refs #949

---
 docs/api-guide/serializers.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/api-guide/serializers.md b/docs/api-guide/serializers.md
index 8e9de10e..a1f0853e 100644
--- a/docs/api-guide/serializers.md
+++ b/docs/api-guide/serializers.md
@@ -308,6 +308,12 @@ By default, all the model fields on the class will be mapped to corresponding se
 
 Any relationships such as foreign keys on the model will be mapped to `PrimaryKeyRelatedField`.  Other models fields will be mapped to a corresponding serializer field.
 
+---
+
+**Note**: When validation is applied to a `ModelSerializer`, both the serializer fields, and their corresponding model fields must correctly validate.  If you have optional fields on your model, make sure to correctly set `blank=True` on the model field, as well as setting `required=False` on the serializer field.
+
+---
+
 ## Specifying which fields should be included
 
 If you only want a subset of the default fields to be used in a model serializer, you can do so using `fields` or `exclude` options, just as you would with a `ModelForm`.
-- 
cgit v1.2.3