#25712: Template overview documentation is not very approachable
-------------------------------+--------------------
Reporter: jbzdak | Owner: nobody
Type: Uncategorized | Status: new
Component: Documentation | Version: 1.8
Severity: Normal | Keywords:
Triage Stage: Unreviewed | Has patch: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------+--------------------
Template overview documentation is not very approachable for new people as
it starts with multiple pages of text, that is really about new plug-in
templates. I'm doing a course on Django (in Warsaw University Of
Technology), and I was browsing for some document that I can point
students to and say: "If you have more time before classes read that".
Pluggable template engines (and template engine configuration) are pretty
advanced subjects so ideally they should be on their own page.
I'd suggest the flowing:
* "Overview" that assumes default Django configuration, and mentions
``CONTEXT_PROCESSORS``. Also has some very brief introduction to with
something along the lines: "Engine templates are now pluggable
configuration is there" (and link to other page)
* Add page about template engine configuration and so on.
* Move information about create your own backend to it's own page (as it
is a very advanced subject --- that in dev tree covers also how to create
debug pages for not-built in engines).
--
Ticket URL: <https://code.djangoproject.com/ticket/25712>
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/049.c4732e517e4a51bdedce13d2c1246f29%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.
