Fixed wrong references

Author: javiereguiluz

components/templating.rst

@@ -28,8 +28,8 @@ Usage
 .. seealso::
 
     This article explains how to use the Templating features as an independent
-    component in any PHP application. Read the :doc:`/templating` article to
-    learn about how to work with templates in Symfony applications.
+    component in any PHP application. Read the article about :doc:`templates </templates>`
+    to learn about how to work with templates in Symfony applications.
 
 The :class:`Symfony\\Component\\Templating\\PhpEngine` class is the entry point
 of the component. It needs a
@@ -211,5 +211,5 @@ Learn More
     :glob:
 
     /components/templating/*
-    /templating
+    /templates
     /templating/*

controller.rst

@@ -179,7 +179,7 @@ object for you::
     return $this->render('lucky/number.html.twig', ['number' => $number]);
 
 Templating and Twig are explained more in the
-:doc:`Creating and Using Templates article </templating>`.
+:doc:`Creating and Using Templates article </templates>`.
 
 .. index::
    single: Controller; Accessing services
@@ -651,15 +651,15 @@ handle caching and more.
 Keep Going!
 -----------
 
-Next, learn all about :doc:`rendering templates with Twig </templating>`.
+Next, learn all about :doc:`rendering templates with Twig </templates>`.
 
 Learn more about Controllers
 ----------------------------
 
 .. toctree::
     :hidden:
 
-    templating
+    templates
 
 .. toctree::
     :maxdepth: 1

getting_started/index.rst

@@ -8,5 +8,5 @@ Getting Started
     /page_creation
     /routing
     /controller
-    /templating
+    /templates
     /configuration

introduction/from_flat_php_to_symfony.rst

@@ -532,7 +532,7 @@ a simple application. Along the way, you've made a simple routing
 system and a method using ``ob_start()`` and ``ob_get_clean()`` to render
 templates. If, for some reason, you needed to continue building this "framework"
 from scratch, you could at least use Symfony's standalone
-:doc:`Routing </components/routing>` component and :doc:`Twig </templating>`,
+:doc:`Routing </components/routing>` component and :doc:`Twig </templates>`,
 which already solve these problems.
 
 Instead of re-solving common problems, you can let Symfony take care of

mailer.rst

@@ -291,7 +291,7 @@ create an event subscriber to set it automatically::
 Twig: HTML & CSS
 ----------------
 
-The Mime component integrates with the :doc:`Twig template engine </templating>`
+The Mime component integrates with the :ref:`Twig template engine <twig-language>`
 to provide advanced features such as CSS style inlining and support for HTML/CSS
 frameworks to create complex HTML email messages. First, make sure Twig is installed:
 

page_creation.rst

@@ -251,8 +251,8 @@ Now you may wonder where the Web Debug Toolbar has gone: that's because there is
 no ``</body>`` tag in the current template. You can add the body element yourself,
 or extend ``base.html.twig``, which contains all default HTML elements.
 
-In the :doc:`/templating` article, you'll learn all about Twig: how to loop, render
-other templates and leverage its powerful layout inheritance system.
+In the :doc:`templates </templates>` article, you'll learn all about Twig: how
+to loop, render other templates and leverage its powerful layout inheritance system.
 
 Checking out the Project Structure
 ----------------------------------
@@ -304,7 +304,7 @@ Ok, time to finish mastering the fundamentals by reading these articles:
 
 * :doc:`/routing`
 * :doc:`/controller`
-* :doc:`/templating`
+* :doc:`/templates`
 * :doc:`/configuration`
 
 Then, learn about other important topics like the

reference/configuration/twig.rst

@@ -5,8 +5,8 @@ Twig Configuration Reference (TwigBundle)
 =========================================
 
 The TwigBundle integrates the Twig library in Symfony applications to
-:doc:`render templates </templating>`. All these options are configured under
-the ``twig`` key in your application configuration.
+:ref:`render templates <templates-rendering>`. All these options are configured
+under the ``twig`` key in your application configuration.
 
 .. code-block:: terminal
 

routing.rst

@@ -1901,7 +1901,7 @@ the :class:`Symfony\\Component\\Routing\\Generator\\UrlGeneratorInterface` class
 Generating URLs in Templates
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The Twig template language used in :doc:`Symfony templates </templating>`
+The Twig template language used in :doc:`Symfony templates </templates>`
 provides some functions to generate both relative and absolute URLs:
 
 .. code-block:: html+twig

templates.rst

@@ -7,7 +7,7 @@ Creating and Using Templates
 A template is a text file that can generate any text-based format (HTML, XML,
 CSV, etc.). For example, in a web application that displays some news, you can
 create a text file (e.g. ``news.php``) with the HTML structure and PHP logic of
-all news pages. Then, a :doc:`Symfony controller </controllers>` can *render*
+all news pages. Then, a :doc:`Symfony controller </controller>` can *render*
 that ``news.php`` template passing the contents of each news to generate the
 resulting HTML contents sent to the user.
 
@@ -64,7 +64,7 @@ available by default. In Symfony applications you can also use these
 :doc:`Twig filters and functions defined by Symfony </reference/twig_reference>`
 and you can :doc:`create your own Twig filters and functions </templating/twig_extension>`.
 
-Twig is fast in the ``prod`` :doc:`environment <configuration-environments>`
+Twig is fast in the ``prod`` :ref:`environment <configuration-environments>`
 (because templates are compiled into PHP and cached automatically), but
 convenient to use in the ``dev`` environment (because templates are recompiled
 automatically when you change them).
@@ -189,6 +189,7 @@ Consider the following routing configuration:
         }
 
     .. code-block:: yaml
+
         # config/routes.yaml
         blog_index:
             path:       /
@@ -338,7 +339,7 @@ gives you access to these variables:
     or a regular request).
 ``app.session``
     The :class:`Symfony\\Component\\HttpFoundation\\Session\\Session` object that
-    represents the current :doc:`user's session </sessions>` or ``null`` if there is none.
+    represents the current :doc:`user's session </session>` or ``null`` if there is none.
 ``app.flashes``
     An array of all the :ref:`flash messages <flash-messages>` stored in the session.
     You can also get only the messages of some type (e.g. ``app.flashes('notice')``).
@@ -356,6 +357,8 @@ gives you access to these variables:
     In addition to the global ``app`` variable injected by Symfony, you can also
     :doc:`inject variables automatically to all Twig templates </templating/global_variables>`.
 
+.. _templates-rendering:
+
 Rendering Templates
 -------------------