Documentation for "Custom permissions" is misleading
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
Change History
(3)
Triage Stage: |
Unreviewed → Accepted
|
Resolution: |
→ fixed
|
Status: |
new → closed
|
(In [14403]) Fixed #13503 -- Corrected misleading custom permission example in the docs.
Thanks Daniel Moisset for the report.