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
8704	Improve context processor documentation	Scot Hacker	Kevin Kubasik	"The answer to the common question ""How do I make variables globally available to my templates?"" is ""context processors,"" which are covered at http://www.djangoproject.com/documentation/templates_python/ .  But a new developer looking for an answer to this question will never find it in the docs by searching for ""global"" or ""global variables."" The documentation is there, but very difficult to find by searching on terms related to the problem. No new developer will know to search for ""context processors.""

Once the right section of the documentation is found, under the cryptic title ""Subclassing Context: RequestContext,"" implementing the code samples on that page will only yield exception errors like ""global name 'RequestContext' is not defined."" Which means absolutely nothing (in terms of the fix) to the new Django developer. The code samples on that page should state that you need to:

from django.template import RequestContext

To promote Django acceptance, make learning the system less painful. Be specific, come up with a tagging system for the documentation to lead new developers to the right spot in the docs, and provide complete implementation details everywhere."		closed	Documentation	dev		fixed	kkmegapatch		Accepted	1	0	0	1	0	0