Added Best Practice guideline for partials/include

timonf · weaverryan · commit bbd705d250d9 · 2017-11-12T15:47:23.000-05:00
diff --git a/best_practices/templates.rst b/best_practices/templates.rst
@@ -53,6 +53,15 @@ scattered through lots of bundles.
 
     Use lowercased snake_case for directory and template names.
 
+.. best-practice::
+
+    Use a prefixed underscore for partial templates in template names.
+
+You often want to reuse template code using the ``include`` function to avoid
+redundant code. To determine those partials easily in the filesystem you should
+prefix partials and any other template without HTML body or ``extends`` tag
+with a single underscore.
+
 Twig Extensions
 ---------------
 
