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
24458	Documentation often overlooks class-based views	Daniel Quinn	Daniel Quinn	"While the explanation of what CBVs are and why we use them is concise, there isn't much in the way of covering how to use them with different components in Django.  Many examples show only how to use a feature with function-based views, with no explanation as to how this would translate to CBVs.  Below I've listed some sections that could use some attention:

* https://docs.djangoproject.com/en/1.7/topics/http/sessions/#setting-test-cookies
* https://docs.djangoproject.com/en/1.7/topics/http/sessions/#examples
* https://docs.djangoproject.com/en/1.7/topics/auth/default/#the-login-required-decorator
* https://docs.djangoproject.com/en/1.7/topics/cache/#the-per-view-cache
* https://docs.djangoproject.com/en/1.7/topics/cache/#using-vary-headers
* https://docs.djangoproject.com/en/1.7/topics/cache/#controlling-cache-using-other-headers
* https://docs.djangoproject.com/en/1.7/topics/pagination/#using-paginator-in-a-view
* https://docs.djangoproject.com/en/1.7/topics/conditional-view-processing/#the-condition-decorator
"	Cleanup/optimization	closed	Documentation	1.7	Normal	worksforme			Accepted	0	0	0	0	1	0