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
22473	Docs for Model.clean() are misleading	anonymous	nobody	"from https://docs.djangoproject.com/en/1.6/ref/models/instances/#django.db.models.Model.clean

----------------
Model.clean()

This method should be used to provide custom model validation, and to modify attributes on your model if desired. For instance, you could use it to automatically provide a value for a field, or to do validation that requires access to more than a single field...
---------------
This is misleading, as it seems to say that Model.clean() is called when saving an object.  It should be made clear here that clean() is for validation in forms.  

Here's someone else who has run into this misunderstanding: http://stackoverflow.com/questions/18803112/django-doesnt-call-model-clean-method"	Uncategorized	closed	Documentation	1.6	Normal	fixed			Unreviewed	0	0	0	0	0	0