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
13503	"Documentation for ""Custom permissions"" is misleading"	Daniel F Moisset	nobody	"The documentation at http://docs.djangoproject.com/en/dev/topics/auth/#id2 gives an example of custom permissions. It Creates a ""USCitizen"" model, and custom permissions ""can drive"", ""can vote"", etc. These makes it look like the permissions system allows you to describe actions performed by models; when actually the permission system allows you to describe actions performed by *users* (django.contrib.auth.models.User) over other models. 

A more realistic (and useful) example, would be something on the lines of a model ""Article"" with permissions ""can publish"" and ""can edit title"", for example
"		closed	Documentation	1.1		fixed			Accepted	0	0	0	0	0	0