#35401: Document the `conditional_page` decorator
-----------------------------------------+------------------------
Reporter: Keryn Knight | Owner: nobody
Type: Uncategorized | Status: new
Component: Documentation | Version: dev
Severity: Normal | Keywords:
Triage Stage: Unreviewed | Has patch: 0
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 0
UI/UX: 0 |
-----------------------------------------+------------------------
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!)
--
Ticket URL: <https://code.djangoproject.com/ticket/35401>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to django-updates+unsubscr...@googlegroups.com.
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/0107018f1024518f-6b45fd94-35ea-495c-b8d7-cbd2a309763a-000000%40eu-central-1.amazonses.com.
