#25963: Docs for render_to_response and context_instance deprecation
-------------------------+-------------------------------------------------
Reporter: | Owner: nobody
marktranchant |
Type: Bug | Status: new
Component: | Version: 1.9
Documentation | Keywords: render, render_to_response,
Severity: Normal | context_instance, RequestContext
Triage Stage: | Has patch: 0
Unreviewed |
Easy pickings: 1 | UI/UX: 0
-------------------------+-------------------------------------------------
The [https://docs.djangoproject.com/en/1.9/topics/http/shortcuts/#render-
to-response render_to_response() documentation] notes the deprecation of
the {{{context_instance}}} argument:
"Deprecated since version 1.8: The {{{context_instance}}} argument is
deprecated. Simply use {{{context}}}."
This advice is singularly unhelpful — it took me a fair amount of
StackOverflow searching to work out what to do. I use the
{{{RequestContext}}} to handle user messages and authorization, so it's
essential for my project.
I'd suggest the note should read:
"Deprecated since version 1.8: The {{{context_instance}}} argument is
deprecated. Simply use {{{render()}}} with the {{{request}}} as the first
argument."
I don't know if that covers all use cases for the deprecation notice: if
not, the original should be expanded to provide a better explanation. I've
dragged my project along since 1.2 so am a fairly old hand yet it didn't
make sense to me.
--
Ticket URL: <https://code.djangoproject.com/ticket/25963>
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 post to this group, send email to [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/056.f8f4ec5aa3d96ee62d32a0939ce45f16%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.
