Fix references

Author: fabpot

_build/redirection_map

@@ -248,7 +248,8 @@
 /cookbook/session/index /session
 /cookbook/session/limit_metadata_writes /reference/configuration/framework
 /session/limit_metadata_writes /reference/configuration/framework
-/cookbook/session/locale_sticky_session /session/locale_sticky_session
+/cookbook/session/locale_sticky_session /session
+/cookbook/locale_sticky_session /session
 /cookbook/session/php_bridge /session/php_bridge
 /cookbook/session/proxy_examples /session/proxy_examples
 /cookbook/session/sessions_directory /session/sessions_directory
@@ -477,8 +478,9 @@
 /components/translation/custom_message_formatter https://github.com/symfony/translation
 /components/notifier https://github.com/symfony/notifier
 /components/routing https://github.com/symfony/routing
-/doctrine/pdo_session_storage /session/database
-/doctrine/mongodb_session_storage /session/database
+/session/database /session
+/doctrine/pdo_session_storage /session
+/doctrine/mongodb_session_storage /session
 /components/dotenv https://github.com/symfony/dotenv
 /components/mercure /mercure
 /components/polyfill_apcu https://github.com/symfony/polyfill-apcu

components/http_foundation.rst

@@ -752,7 +752,7 @@ the response content will look like this:
 Session
 -------
 
-The session information is in its own document: :doc:`/components/http_foundation/sessions`.
+The session information is in its own document: :doc:`/session`.
 
 Safe Content Preference
 -----------------------
@@ -829,10 +829,9 @@ Learn More
     :maxdepth: 1
     :glob:
 
-    /components/http_foundation/*
     /controller
     /controller/*
-    /session/*
+    /session
     /http_cache/*
 
 .. _nginx: https://www.nginx.com/resources/wiki/start/topics/examples/xsendfile/

doctrine.rst

@@ -882,7 +882,6 @@ Learn more
     doctrine/multiple_entity_managers
     doctrine/resolve_target_entity
     doctrine/reverse_engineering
-    session/database
     testing/database
 
 .. _`Doctrine`: https://www.doctrine-project.org/

reference/configuration/framework.rst

@@ -1582,7 +1582,7 @@ handler_id
 The service id used for session storage. The default value ``'session.handler.native_file'``
 will let Symfony manage the sessions itself using files to store the session metadata.
 Set it to ``null`` to use the native PHP session mechanism.
-You can also :doc:`store sessions in a database </session/database>`.
+You can also :ref:`store sessions in a database <session-database>`.
 
 .. _name:
 

security/impersonating_user.rst

@@ -370,9 +370,9 @@ The firewall dispatches the ``security.switch_user`` event right after the imper
 is completed. The :class:`Symfony\\Component\\Security\\Http\\Event\\SwitchUserEvent` is
 passed to the listener, and you can use this to get the user that you are now impersonating.
 
-The :doc:`/session/locale_sticky_session` article does not update the locale
-when you impersonate a user. If you *do* want to be sure to update the locale when
-you switch users, add an event subscriber on this event::
+The :ref:`locale-sticky-session` section does not update the locale when you
+impersonate a user. If you *do* want to be sure to update the locale when you
+switch users, add an event subscriber on this event::
 
     // src/EventListener/SwitchUserSubscriber.php
     namespace App\EventListener;

session.rst

@@ -235,7 +235,7 @@ by the :ref:`Twig global app variable <twig-app-variable>`:
             {% endfor %}
         {% endfor %}
 
-    .. code-block:: standalone-php
+    .. code-block:: php-standalone
 
         // display warnings
         foreach ($session->getFlashBag()->get('warning', []) as $message) {
@@ -445,6 +445,8 @@ timestamp and the lifetime.
 .. index::
     single: Session; Database Storage
 
+.. _session-database:
+
 Store Sessions in a Database
 ----------------------------
 
@@ -1132,15 +1134,18 @@ This is the recommended migration workflow:
 #. After verifying that the sessions in your application are working, switch
    from the migrating handler to the new handler.
 
+.. index::
+    single: Sessions, saving locale
+
+.. _locale-sticky-session:
+
 Making the Locale "Sticky" during a User's Session
 --------------------------------------------------
 
 Symfony stores the locale setting in the Request, which means that this setting
 is not automatically saved ("sticky") across requests. But, you *can* store the
 locale in the session, so that it's used on subsequent requests.
 
-.. _creating-a-LocaleSubscriber:
-
 Creating a LocaleSubscriber
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -1588,18 +1593,6 @@ the example below:
     can use the Symfony save handler without side effects and that the session
     has not been started before Symfony is initialized.
 
-More about Sessions
--------------------
-
-.. toctree::
-    :maxdepth: 1
-
-    session/database
-    session/locale_sticky_session
-    session/php_bridge
-    session/proxy_examples
-
-.. _`HttpFoundation component`: https://symfony.com/components/HttpFoundation
 .. _`phpredis extension`: https://github.com/phpredis/phpredis
 .. _`DoctrineMongoDBBundle configuration`: https://symfony.com/doc/master/bundles/DoctrineMongoDBBundle/config.html
 .. _`MongoDB shell`: https://docs.mongodb.com/manual/mongo/

translation.rst

@@ -39,7 +39,7 @@ The translation process has several steps:
 
 #. Determine, :doc:`set and manage the user's locale </translation/locale>`
    for the request and optionally
-   :doc:`on the user's entire session </session/locale_sticky_session>`.
+   :ref:`on the user's entire session <locale-sticky-session>`.
 
 Installation
 ------------

translation/locale.rst

@@ -33,8 +33,8 @@ it::
     listener priority to a higher value than ``LocaleListener`` priority (which
     you can obtain by running the ``debug:event kernel.request`` command).
 
-Read :doc:`/session/locale_sticky_session` for more information on making
-the user's locale "sticky" to their session.
+Read :ref:`locale-sticky-session` for more information on making the user's
+locale "sticky" to their session.
 
 .. note::