4a954cfd11
Fixed #30573 -- Rephrased documentation to avoid words that minimise the involved difficulty.
...
This patch does not remove all occurrences of the words in question.
Rather, I went through all of the occurrences of the words listed
below, and judged if they a) suggested the reader had some kind of
knowledge/experience, and b) if they added anything of value (including
tone of voice, etc). I left most of the words alone. I looked at the
following words:
- simply/simple
- easy/easier/easiest
- obvious
- just
- merely
- straightforward
- ridiculous
Thanks to Carlton Gibson for guidance on how to approach this issue, and
to Tim Bell for providing the idea. But the enormous lion's share of
thanks go to Adam Johnson for his patient and helpful review.
2019-09-06 13:27:46 +02:00
35319bf12c
Alphabetized imports in various docs.
...
Follow-up of d97cce34097d3fe36c62
2018-05-12 19:37:42 +02:00
8863c475c5
Fixed #27821 -- Clarified docs of the return value of Form.clean_<fieldname>().
...
Thanks Christian Ullrich for the report and review.
2017-02-08 08:38:08 -05:00
dc165ec8e5
Refs #23919 -- Replaced super(ClassName, self) with super() in docs.
2017-01-25 11:53:05 -05:00
2032bcf182
Fixed #26806 -- Triple quoted docstrings in docs/ref/forms/validation.txt.
2016-06-27 09:06:54 -04:00
bca9faae95
Fixed #26020 -- Normalized header stylings in docs.
2016-01-22 12:12:17 -05:00
1aa8bf9b43
Fixed typo in docs/ref/forms/validation.txt.
2015-12-09 07:20:33 -05:00
80855a4b37
Fixed #21894 -- Corrected a form.clean() example in case a superclass doesn't return data.
2015-10-21 13:50:48 -04:00
b9bf61ce61
Used PEP 8 style indentation in forms docs.
2015-06-11 12:21:53 -04:00
73b5b0b4a5
Minor edits to docs/ref/forms/validation.txt
2015-05-25 13:19:21 -04:00
66f5aa9fa5
Fixed typos in docs/ref/forms/validation.txt.
2015-02-03 12:26:58 -05:00
c79faae761
Removed versionadded/changed notes for 1.7.
2015-02-01 21:02:40 -05:00
38ab0f13fa
Added missing backticks to form validation docs
2014-11-20 11:09:21 -05:00
f1f0c4f16b
Removed confusing paragraph from the docs.
...
This snippet wasn't particularly helpful as `add_error()` is described
in greater details in the following section.
Thanks Claude Paroz for the report.
2014-11-05 16:00:30 +07:00
ab9c886459
Fixed #23391 -- Removed an erroneous backtip from the form's documentation.
...
Thanks to Trac alias nessita for the report.
2014-08-31 20:06:38 -04:00
874053edf9
Fixed #21942 -- Moved Form.clean() to form API docs.
...
Thanks cjerdonek for the suggestion.
2014-06-30 16:30:57 -04:00
c307383ec9
Fixed typo in docs/ref/forms/validation.txt.
2014-06-11 17:17:21 -04:00
d2f4553d70
Fixed #22216 -- Added Form.non_field_errors to form API doc.
2014-04-05 18:16:01 -04:00
51c8045145
Removed versionadded/changed annotations for 1.6.
2014-03-24 11:42:56 -04:00
3a97f992fb
Fixed #22313 -- Removed 'u' prefixes from documentation
2014-03-22 21:32:20 +01:00
2e4200b5c7
Fixed #21654 -- Documented a use-case for Form.errors.as_data().
...
Thanks selwin for the suggestion.
2014-02-14 06:52:50 -05:00
05d36dc06e
Always use parentheses when documenting a method with no arguments.
2014-01-22 22:26:10 +01:00
b72b85af15
Removed Form._errors from the docs in favor of the add_error API.
2013-11-30 01:00:53 +07:00
f563c339ca
Fixed #20867 -- Added the Form.add_error() method.
...
Refs #20199 #16986 .
Thanks @akaariai, @bmispelon, @mjtamlyn, @timgraham for the reviews.
2013-11-30 01:00:53 +07:00
0048ed77c7
Fixed typos in previous commit ( 9aa6d4bdb6).
2013-11-12 20:42:44 +01:00
9aa6d4bdb6
Removed a mention of `Form._errors` from the documentation.
...
Also removed a sentence that was incorrect: raising a
`ValidationError` inside `Form.clean` doesn't clear the
`cleaned_data` attribute.
Thanks to loic84 and timograham for the review.
2013-11-12 20:27:21 +01:00
98e0453f00
Fixed #21120 -- Added more explicit text on using validators and link to writing validators.
...
Thanks nicolas at niconomicon.net for the suggestion.
2013-09-23 10:37:41 -04:00
18ffdb1772
Fixed #17627 -- Renamed util.py files to utils.py
...
Thanks PaulM for the suggestion and Luke Granger-Brown and
Wiktor Kołodziej for the initial patch.
2013-09-16 12:52:05 -04:00
ebfe42d018
Fixed #21009 -- Added a versionchanged note regarding changes to clean().
...
refs [fb1dd6b13a1c4a9bd9ad
2013-09-05 05:47:45 -04:00
7b69c3e775
Removed versionadded/changed annotations for 1.5
2013-08-19 09:09:41 -04:00
8442268869
Added an anchor for django.forms.Form.clean in docs
2013-08-08 14:13:52 -04:00
fb1dd6b13a
Form.clean() does not need to return cleaned_data.
...
If it does, that will be used as the cleaned_data. The default
implementation has been changed to match this change.
2013-08-08 14:05:55 +01:00
05ea5a2139
Fixed #20823 -- Typo in docs/ref/forms/validation.txt
2013-07-29 18:41:08 -04:00
ee77d4b253
Fixed #20199 -- Allow ModelForm fields to override error_messages from model fields
2013-06-18 08:01:17 -04:00
08b501e7d3
add missing imports to the examples in the 'Forms'
2013-05-19 13:31:45 +02:00
78c842a323
Adapted uses of versionchanged/versionadded to the new form.
...
Refs #20104 .
2013-04-20 17:18:35 +02:00
2f121dfe63
Fixed #17051 -- Removed some 'invalid' field error messages
...
When the 'invalid' error message is set at field level, it masks
the error message raised by the validator, if any.
2013-03-14 17:03:43 +01:00
2c8267bf3d
Fixed #17899 -- Rewrote [Ee]-mail to [Ee]mail
2012-09-26 14:14:51 +02:00
c634375e9c
clarify clean_<field> docs, ticket #18917
2012-09-07 10:43:55 -04:00
121fd109de
Fixed #5524 -- Do not remove cleaned_data when a form fails validation
...
cleaned_data is no longer deleted when form validation fails but only
contains the data that did validate.
Thanks to the various contributors to this patch (see ticket).
2012-08-04 14:22:23 +02:00
33999d9871
Fixed #18445 -- Added a links in the docs.
...
Thanks Audrey Roy for the patch.
2012-06-07 22:11:24 +02:00
4a103086d5
Fixed #18269 -- Applied unicode_literals for Python 3 compatibility.
...
Thanks Vinay Sajip for the support of his django3 branch and
Jannis Leidel for the review.
2012-06-07 18:08:47 +02:00
c28e700c7e
Removed references to changes made in 1.2.
...
Thanks Florian Apolloner for the patch.
2012-06-07 15:02:35 +02:00
52d72a5a3e
Fixed #17182 -- Changed best practice documentation for Form.clean to use super() instead of relying on self.cleaned_data. Thanks, DrMeers.
...
git-svn-id: http://code.djangoproject.com/svn/django/trunk@17433 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2012-02-04 16:05:30 +00:00
d1e5c55258
Fixed many more ReST indentation errors, somehow accidentally missed from [16955]
...
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16983 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2011-10-14 00:12:01 +00:00
5ecb88c146
Fixed #16014 -- numerous documentation typos -- thanks psmith.
...
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16220 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2011-05-13 04:33:42 +00:00
9a279edc1c
Fixed some ReST errors from e-mail -> email change in docs, and changed some docs that shouldn't have been changed (because translation strings haven't been converted yet)
...
git-svn-id: http://code.djangoproject.com/svn/django/trunk@15968 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2011-04-01 16:18:23 +00:00
94af19c43f
Changed e-mail to email throughout documentation and codebase. The one exception is translation strings, which I didn't want to disrupt
...
git-svn-id: http://code.djangoproject.com/svn/django/trunk@15967 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2011-04-01 16:10:22 +00:00
456534dda9
Fixed #15191 - typo in form validation docs; thanks berto for the report.
...
git-svn-id: http://code.djangoproject.com/svn/django/trunk@15372 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2011-01-30 19:09:44 +00:00
c8bcd5e547
Fixed #14205 - Tiny grammar fix in form validation documentation
...
Thanks to zendak for report and patch.
git-svn-id: http://code.djangoproject.com/svn/django/trunk@13687 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-09-07 20:19:41 +00:00
Tobias Kunze
Mariusz Felisiak
Tim Graham
chillaranand
Anderson Resende
Elif T. Kus
Andrew Plummer
Nick Smith
I am Clinton
minusf
Alasdair Nicol
Loic Bistuer
Simon Charette
Maxime Lorant
Claude Paroz
Loic Bistuer
Baptiste Mispelon
Ben Huckvale
Marc Tamlyn
leandrafinger
Juan Catalano
Adrien Lemaire
Brad Pitcher
Aymeric Augustin
Jannis Leidel
Luke Plant
Simon Meers
Adrian Holovaty