#12505: Formsets: Misleading documentation ---------------------------+------------------------------------------------ Reporter: Andreas | Owner: nobody Status: new | Milestone: Component: Documentation | Version: 1.1 Keywords: formset | Stage: Unreviewed Has_patch: 0 | ---------------------------+------------------------------------------------ The example of the documentation at <http://docs.djangoproject.com/en/dev/topics/forms/formsets/#using- initial-data-with-a-formset> is maybe not optimal to explain how the 'extra' and 'initial' parameters of a formset work together. It looks like the total number of forms is always extra + 1 (in fact, 'extra' somehow suggests the additional number of forms with respect to a standard, single form). Then, it looks like these forms are filled with the content of the dicts in the initial_list. Even though the correct behaviour is described in the text, this is easily overread, since usually the examples are the best documentation ;-) If you'd provide in the example for example 'extra=1' and then pass a list with two dicts as 'initial', I think the behaviour would be more obvious. We were just struggling over an hour until we got it.
-- Ticket URL: <http://code.djangoproject.com/ticket/12505> Django <http://code.djangoproject.com/> The Web framework for perfectionists with deadlines. -- You received this message because you are subscribed to the Google Groups "Django updates" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/django-updates?hl=en.
