More Group Documentation in the Auth Page

[b14ck]

The Django auth documentation: ​http://docs.djangoproject.com/en/dev/topics/auth/ contains very little information about Groups. The documentation does not provide any API reference material for the models.Group objects, and does not go into any detail about how to create, use, or edit groups.

I think that adding in more information about the Group object would be beneficial to coders developing sites that rely heavily on authentication and complex permission schemas.

[James Bennett]

Not anywhere near critical enough to go on 1.2.

[John Paulett]

Add Group API reference and Permission API example

[patchhammer]

13211.diff fails to apply cleanly on to trunk

[CrazyGir]

updated original diff to apply against current trunk

[CrazyGir]

First contribution here, please excuse me if I overlook something helpful/important. Thank djangocon for inspiring me to get more involved. I hope this is just the beginning :)

I've taken the previously attached diff and updated it to ensure it applies cleanly to the current trunk revision. I have also made a few updates to the diff to better fit conventions I noticed within the auth docs. I have used built the docs as well, to ensure the changes fit correctly - I believe this is correct but confirmation on this would be great :)

I am removing the "needs improvement" flag, please reflag if you feel more should be tweaked. I believe additional documentation on using Groups might be nice, but I wanted to focus on the first step to get this patch applying cleanly.

[Julien Phalip]

In [16849]:

Fixed #13211 -- Added the Group API reference and a Permission API example to the contrib.auth documentation. Thanks to b14ck for the report and to jpaulett and CrazyGir for the patch.