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
9414	Documentation on has_perm and the permission_required decorator is confusing	wallenfe	Jacob	"The documentation on using has_perm and permission_required is confusing in that it does not define how the permission string that is passed to those functions is defined.

The documentation should mention that the string is:
ApplicationName.PermissionName.

Since Permissions are defined on models, my first inclination was to try: ModelName.PermissionName


This is the documentation page I am referring to:
http://docs.djangoproject.com/en/dev/topics/auth/#topics-auth

And an example of the permission string being used, but without an explanation.
""
def my_view(request):
    if not (request.user.is_authenticated() and request.user.has_perm('polls.can_vote')):
""
"		closed	Documentation	dev		fixed			Ready for checkin	1	0	0	0	0	0