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
25963	Clarify docs for render_to_response and context_instance deprecation	Mark Tranchant	Tim Graham	"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 0.96 so am a fairly old hand yet it didn't make sense to me."	Bug	closed	Documentation	1.9	Normal	fixed	render, render_to_response, context_instance, RequestContext		Accepted	1	0	0	0	1	0