Document difference in cleaning between initial and data parameter when using dynamic initial parameters

[Manuel Saelices]

I think is important to note that dynamic initial data created in a form is not cleaned, unlike data parameter. It could causes developer fails like caused by ticket #5145. This is an example what I refer:

    >>> class NewsForm(forms.Form):
    ...     date = forms.DateField()
    ...     title = forms.CharField()
    >>> f = NewsForm(initial={'date': 'not_a_date'})
    >>> f.as_table()
    <tr><th><label for="id_date">Date:</label></th><td><input type="text" name="date" value="not_a_date" id="id_date" /></td></tr>
    <tr><th><label for="id_title">Title:</label></th><td><input type="text" name="title" id="id_title" /></td></tr>

[Manuel Saelices]

Documentation patch

[Nis Jørgensen <nis@…>]

I merged my own docs from 5145 into the ones in the previous page.

[Nis Jørgensen <nis@…>]

I updated with a sentence specific to 5145.

[Manuel Saelices]

Mmmm... I think your last sentence could be confusing for the user, because he doesn't know what is a MultiValued (docs has not written yet and besides his location is after this).

[James Bennett]

The current docs explain this and actually use initial as an example of a way to supply data which bypasses validation.