#10239: Document modelform_factory
------------------------------------------+-------------------------------
Reporter: ingenieroariel | Owner: nobody
Type: New feature | Status: new
Milestone: | Component: Documentation
Version: SVN | Severity: Normal
Resolution: | Keywords: dceu2011
Triage Stage: Accepted | Has patch: 1
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 1 | Easy pickings: 0
UI/UX: 0 |
------------------------------------------+-------------------------------
Changes (by gabrielhurley):
* needs_better_patch: 0 => 1
* stage: Design decision needed => Accepted
Comment:
While I can understand that this method may have been originally
considered internal, I don't see any significant reason why it is more
internal than `modelformset_factory`, which is documented. Additionally,
I've certainly seen it in use by the community in numerous places.
Changing it substantially in a backwards-incompatible way without
documentation would be detrimental at this stage.
As for this patch, there's a significant typo on line 540:
"modelformset_factory" should be "modelform_factory".
However, what really bothers is that the only documentation for
`ModelForm` and `modelformset_factory` right now is in the topic guide.
There direly needs to be a API reference for these in addition to just
adding another section to the topic guide.
If this patch expands to include a reference doc (new) as well as the
existing improvements then I'd be willing to commit it.
--
Ticket URL: <https://code.djangoproject.com/ticket/10239#comment:7>
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 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.
