documentation clarifications on ModelForms & ModelFormsets Meta fields
|Reported by:||Owned by:||Raúl Cumplido|
|Severity:||Normal||Keywords:||ModelForm, Meta class, easy-pickings|
|Cc:||Triage Stage:||Ready for checkin|
|Has patch:||yes||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
Based on discussion from this thread:
the documentation of the fields attribute of a ModelForms inner Meta class should be clarified/expanded. Basically, add a sentence that states if you define fields (or excludes) on an inner Meta class, any excluded field 1) will not appear on the form by default, 2) will not be initialized from a model instance if manually added back to the form, and 3) will not be set by the form's save method. A similar caveat should be added to the ModelFormset documentation.
In the current documentation:
Points 1 & 3 are mentioned, but 2 is not.
Change History (14)
comment:2 Changed 6 years ago by