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
6891	Modelform documentation on editing an existing object needs to be updated.	Eric Holscher	nobody	"In the documentation in the section: the save method:
http://www.djangoproject.com/documentation/modelforms/#the-save-method

It is unclear that when you are creating a modelform of POSTed object, the correct syntax is:
{{{
article = Article.objects.get(pk=id)
new = ModelForm(request.POST, article)
new.save()
}}}

for when you are trying to update an object, instead of create a new one.

The code section:

{{{

# Create a form instance with POST data.
>>> a = Author()
>>> f = AuthorForm(request.POST, instance=a)

# Create and save the new author instance. There's no need to do anything else.
>>> new_author = f.save()
}}}

is the second example of creating a form with POST data, and should instead show how to update a form with POST data.

"		closed	Documentation	dev		fixed			Ready for checkin	1	0	0	0	0	0