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
35401	Document the `conditional_page` decorator	Keryn Knight	Lufafa Joshua	"The [https://docs.djangoproject.com/en/dev/ref/middleware/#module-django.middleware.gzip GZip Middleware documentation] makes mention of the [https://docs.djangoproject.com/en/dev/topics/http/decorators/#django.views.decorators.gzip.gzip_page gzip_page decorator], but the [https://docs.djangoproject.com/en/dev/ref/middleware/#module-django.middleware.http Conditional GET middleware] doesn't mention there's an equivalent `conditional_page` decorator, likely ecause there's no mention of that in the [https://docs.djangoproject.com/en/dev/topics/http/decorators/ HTTP decorators] or in the [https://docs.djangoproject.com/en/dev/topics/conditional-view-processing/ Conditional View Processing] topics.

As far as I can tell, the named decorator has been around since [https://github.com/django/django/blob/stable/0.90.x/django/views/decorators/http.py#L9 0.9x] and it's probably just accidentally not described anywhere, when everything else in that module is.

See also: #6181 and [https://www.b-list.org/weblog/2007/dec/11/http/ this blog post describing the intent, from James Bennett back in 2007] (yay for cool URIs which haven't suffered link rot!)"	Cleanup/optimization	closed	Documentation	dev	Normal	fixed			Ready for checkin	1	0	0	0	0	0