django/django — pull request #144 by pydanny (2012-06-08 15:40:54+00:00)
Title: #18451 Improved class based view documentation

For https://code.djangoproject.com/ticket/18451

Ref Improvements:

* Documentation moved to /ref/class-based-views/ directory.
* Method Resolution Order (MRO) on most views.
* Method flowchart added to many views.
* Mixins moved to their own pages.
* Mixins demonstrate which other Mixins they extend.
* Autodoc added to all views and mixins.
* Because the Django code does always not contain docstrings, or it is not complete, there remains in many cases the old manual documentation.
* 'Note' statements placed whenever autodoc is in addition to manual documentation.

Topic Improvements:

* Documentation moved to /topics/class-based-views/ directory.
* Cleaner explanation including additional examples.
* More examples.
* Mixins moved to their own pages.
* Very clean mixin documentation with advocacy for best practices.

Authors:

* Daniel Greenfeld
* James Aylett
* Marc Tamlyn
* Simon Williams