Explained the structure of django.template.

1 files changed, 41 insertions, 0 deletions

diff --git a/django/template/__init__.py b/django/template/__init__.py
index 31f3078bad..510b293e79 100644
--- a/django/template/__init__.py
+++ b/django/template/__init__.py
@@ -1,3 +1,44 @@
+"""
+Django's support for templates.
+
+The django.template namespace contains two independent subsystems:
+
+1. Multiple Template Engines: support for pluggable template backends,
+   built-in backends and backend-independent APIs
+2. Django Template Langage: Django's own template engine, including its
+   built-in loaders, context processors, tags and filters.
+
+Ideally these subsystems would be implemented in distinct packages. However
+keeping them together made the implementation of Multiple Template Engines
+less disruptive .
+
+Here's a breakdown of which modules belong to which subsystem.
+
+Multiple Template Engines:
+
+- django.template.backends.*
+- django.template.loader
+- django.template.response
+
+Django Template Language:
+
+- django.template.base
+- django.template.context
+- django.template.context_processors
+- django.template.loaders.*
+- django.template.debug
+- django.template.defaultfilters
+- django.template.defaulttags
+- django.template.engine
+- django.template.loader_tags
+- django.template.smartif
+
+Shared:
+
+- django.template.utils
+
+"""
+
 ### Multiple Template Engines
 
 from .utils import EngineHandler