Applied comments

Author: wouterj

reference/twig_reference.rst

@@ -19,7 +19,7 @@ There may also be tags in bundles you use that aren't listed here.
 Functions
 ---------
 
-.. _function.render:
+.. _reference_twig.function.render:
 
 render
 ~~~~~~
@@ -40,6 +40,8 @@ options
 Renders the fragment for the given controller (using `controller() <controller>`_)
 or URI. For more information, see :ref:`templating-embedding-controller`.
 
+The render strategy can be specified in the ``strategy`` key of the options. 
+
 .. tip::
 
     The URI can be generated by other methods, like `path <path>`_ and
@@ -65,6 +67,13 @@ Generates an ESI tag when possible or falls back to the behaviour of
 
     The URI can be generated by other methods, like `path <path>`_ and
     `url() <url>`_.
+    
+.. tip::
+
+    The ``render_esi()`` function is an example of the shortcut functions
+    of ``render``. It automatically sets the strategy based on what's given
+    in the function name, e.g. ``render_hinclude()`` will use the hinclude.js
+    strategy. This works for all ``render_*()`` functions.
 
 controller
 ~~~~~~~~~~
@@ -84,7 +93,7 @@ query
     **type**: ``array`` **default**: ``[]``
 
 Returns an instance of ``ControllerReference`` to be used with functions like
-`render() <function.render>` and `render_esi() <render_esi>`.
+:ref:`render() <reference_twig.function.render>` and `render_esi() <render_esi>`.
 
 asset
 ~~~~~
@@ -128,7 +137,7 @@ variables
     **type**: ``array`` **default**: ``[]``
 
 Renders the HTML of a complete form, more information in
-:ref:`the Twig Form reference<reference-forms-twig-form>`.
+:ref:`the Twig Form reference <reference-forms-twig-form>`.
 
 form_start
 ~~~~~~~~~~
@@ -143,7 +152,7 @@ variables
     **type**: ``array`` **default**: ``[]``
 
 Renders the HTML start tag of a form, more information in
-:ref:`the Twig Form reference<reference-forms-twig-start>`.
+:ref:`the Twig Form reference <reference-forms-twig-start>`.
 
 form_end
 ~~~~~~~~
@@ -158,7 +167,7 @@ variables
     **type**: ``array`` **default**: ``[]``
 
 Renders the HTML end tag of a form together with all fields that have not been
-rendered yet, more information in :ref:`the Twig Form reference<reference-forms-twig-end>`.
+rendered yet, more information in :ref:`the Twig Form reference <reference-forms-twig-end>`.
 
 form_enctype
 ~~~~~~~~~~~~
@@ -366,8 +375,6 @@ text
 Makes a technical name human readable (i.e. replaces underscores by spaces and
 capitalizes the string).
 
-.. _filter.trans:
-
 trans
 ~~~~~
 
@@ -387,8 +394,6 @@ locale
 Translates the text into the current language. More information in
 :ref:`Translation Filters <book-translation-filters>`.
 
-.. _filter.transchoice:
-
 transchoice
 ~~~~~~~~~~~
 
@@ -570,8 +575,6 @@ Sets the resources to override the form theme for the given form view instance.
 You can use ``_self`` as resources to set it to the current resource. More
 information in :doc:`/cookbook/form/form_customization`.
 
-.. _tag.trans:
-
 trans
 ~~~~~
 
@@ -588,8 +591,6 @@ locale
 
 Renders the translation of the content. More information in :ref:`book-translation-tags`.
 
-.. _tag.transchoice:
-
 transchoice
 ~~~~~~~~~~~