#27280: can_order/can_delete documentation examples don't require initial data
-------------------------------------+-------------------------------------
     Reporter:  Michael              |                    Owner:  nobody
         Type:                       |                   Status:  closed
  Cleanup/optimization               |
    Component:  Documentation        |                  Version:  1.10
     Severity:  Normal               |               Resolution:  invalid
     Keywords:                       |             Triage Stage:
                                     |  Unreviewed
    Has patch:  0                    |      Needs documentation:  0
  Needs tests:  0                    |  Patch needs improvement:  0
Easy pickings:  0                    |                    UI/UX:  0
-------------------------------------+-------------------------------------

Comment (by Michael):

 Replying to [comment:12 Tim Graham]:
 > Thanks, I updated the wording on the pull request. Feel free to comment
 on the pull request if it's still unclear.

 Let me comment in this ticket. I would say, the wording is really unclear:

 {{{
 If you use an ``initial`` for displaying a formset, you should pass the
 same
 ``initial`` when processing that formset's submission so that the formset
 can
 detect which forms were changed by the user. For example, you might have
 something like: ``ArticleFormSet(request.POST, initial=[...])``.
 }}}

 1. If one passes initial, it does not matter that s/he should pass the
 same initial again. Maybe one wants just show initial data.
 2. To the best of my ability the only case I can imagine when one needs
 both initial and data is for has_changed() method. But you are writing
 documentation for "Using initial data with a formset" section. Whereas
 has_changed() is in "Formset validation" section (by the way, illustrated
 very badly).

--
Ticket URL: <https://code.djangoproject.com/ticket/27280#comment:13>
Django <https://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 unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/064.a8f97d1eec598bc633ff4a0126dd55e2%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to