[#2432] Tweaking language around Required constraint

weaverryan · weaverryan · commit cf049edc6722 · 2013-04-09T17:37:15.000-05:00
diff --git a/reference/constraints/Collection.rst b/reference/constraints/Collection.rst
@@ -224,10 +224,11 @@ field is optional but must be a valid email if supplied, you can do the followin
             }
         }
 
-Even without ``allowMissingFields`` set to true, you can now omit the ``alternate_email`` property 
-completely from the ``profileData`` array, since it is ``Optional``. However, if the the ``personal_email`` 
-field does not exist in the array there will be a constraint violation that the field is missing, 
-since it is ``Required``.
+Even without ``allowMissingFields`` set to true, you can now omit the ``alternate_email``
+property completely from the ``profileData`` array, since it is ``Optional``.
+However, if the the ``personal_email`` field does not exist in the array,
+the ``NotBlank`` constraint will still be applied (since it is wrapped in
+``Required``) and you will receive a constraint violation.
 
 Options
 -------

Original file line number	Diff line number	Diff line change
`@@ -224,10 +224,11 @@ field is optional but must be a valid email if supplied, you can do the followin`
`224`	`224`	`}`
`225`	`225`	`}`
`226`	`226`
`227`		-Even without ``allowMissingFields`` set to true, you can now omit the ``alternate_email`` property
`228`		-completely from the ``profileData`` array, since it is ``Optional``. However, if the the ``personal_email``
`229`		`-field does not exist in the array there will be a constraint violation that the field is missing,`
`230`		-since it is ``Required``.
	`227`	+Even without ``allowMissingFields`` set to true, you can now omit the ``alternate_email``
	`228`	+property completely from the ``profileData`` array, since it is ``Optional``.
	`229`	+However, if the the ``personal_email`` field does not exist in the array,
	`230`	+the ``NotBlank`` constraint will still be applied (since it is wrapped in
	`231`	+``Required``) and you will receive a constraint violation.
`231`	`232`
`232`	`233`	`Options`
`233`	`234`	`-------`