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.
