#8704: Global variables documentation (context processors)
---------------------------+------------------------------------------------
 Reporter:  shacker        |       Owner:  nobody    
   Status:  new            |   Milestone:            
Component:  Documentation  |     Version:  SVN       
 Keywords:                 |       Stage:  Unreviewed
Has_patch:  0              |  
---------------------------+------------------------------------------------
 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.

-- 
Ticket URL: <http://code.djangoproject.com/ticket/8704>
Django Code <http://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 post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/django-updates?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to