Opened 5 years ago

Closed 5 years ago

#12515 closed (duplicate)

confusing wording - formset Extra parameter

Reported by: smalldocerror Owned by: nobody
Component: Documentation Version: 1.1
Severity: Keywords: formset extra= param
Cc: Triage Stage: Unreviewed
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: UI/UX:

Description

On page http://docs.djangoproject.com/en/dev/topics/forms/formsets/

You say

"As you can see it only displayed one form. This is because by default the formset_factory defines one extra form. This can be controlled with the extra parameter:"

I find this confusing. I think the first instance of the word "extra" is wrong.
It should be...

"As you can see it only displayed one form. This is because by default the formset_factory defines one [delete the word "extra" here] form. This can be controlled with the extra parameter:"

That is, ONE form is created by default. Not one EXTRA form.

The text for the next example confirms my belief.

"There are now a total of three forms showing above. One for the initial data that was passed in and two extra forms."

So, by default ONE form, not one extra. And if you say extra=1 (over-riding the default of extra=0?) then you get one EXTRA form.

But what do I know?

(wow, you make it hard to report a small bug! frickin spammers...)

Change History (1)

comment:1 Changed 5 years ago by timo

  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset
  • Resolution set to duplicate
  • Status changed from new to closed

#12505 describes the confusion in a slightly different way.

Note: See TracTickets for help on using tickets.
Back to Top