#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 [email protected].
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.
