id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
11674	documentation clarifications on ModelForms & ModelFormsets Meta fields	david.h.haas@…	Raúl Cumplido	"Based on discussion from this thread:

http://groups.google.com/group/django-users/browse_thread/thread/19a8b01d87819119/217ac9ecee6f474f

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:

http://docs.djangoproject.com/en/dev/topics/forms/modelforms/#using-a-subset-of-fields-on-the-form

Points 1 & 3 are mentioned, but 2 is not.
   "	Cleanup/optimization	closed	Documentation	dev	Normal	fixed	ModelForm, Meta class, easy-pickings		Ready for checkin	1	0	0	0	1	0