clarification difference between function and tag includes

cordoval · weaverryan · commit cf952da9a779 · 2013-07-20T15:12:07.000-05:00
diff --git a/book/templating.rst b/book/templating.rst
@@ -561,8 +561,10 @@ Including this template from any other template is simple:
 
 The template is included using the ``{{ include() }}`` function. Notice that the
 template name follows the same typical convention. The ``articleDetails.html.twig``
-template uses an ``article`` variable. This is passed in by the ``list.html.twig``
-template using the ``with`` command.
+template uses an ``article`` variable. This could be passed in by the ``list.html.twig``
+template using the ``with`` command supported on a twig ``include`` tag. In this
+case however, we opt to use the twig ``include`` function which passes context automatically
+and passes also optional hashes.
 
 .. tip::
 
