Fixed #21654 -- Documented a use-case for Form.errors.as_data().

Thanks selwin for the suggestion.

1 files changed, 7 insertions, 0 deletions

diff --git a/docs/ref/forms/validation.txt b/docs/ref/forms/validation.txt
index 569e7e77e7..78a022d436 100644
--- a/docs/ref/forms/validation.txt
+++ b/docs/ref/forms/validation.txt
@@ -179,6 +179,13 @@ to override your error message you can still opt for the less verbose::
 
     ValidationError(_('Invalid value: %s') % value)
 
+.. versionadded:: 1.7
+
+The :meth:`Form.errors.as_data() <django.forms.Form.errors.as_data()>` and
+:meth:`Form.errors.as_json() <django.forms.Form.errors.as_json()>` methods
+greatly benefit from fully featured ``ValidationError``\s (with a ``code`` name
+and a ``params`` dictionary).
+
 Raising multiple errors
 ~~~~~~~~~~~~~~~~~~~~~~~