[#4875] Minor language tweaks

Author: weaverryan

cookbook/session/locale_sticky_session.rst

@@ -113,15 +113,16 @@ Setting the Locale Based on the User's Preferences
 You might want to improve this technique even further and define the locale based on
 the user entity of the logged in user. However, since the ``LocaleListener`` is called
 before the ``FirewallListener``, which is responsible for handling authentication and
-is setting the user token into the ``TokenStorage``, you have no access to the user
+setting the user token on the ``TokenStorage``, you have no access to the user
 which is logged in.
 
-Let's pretend you have defined a property "locale" in your user entity which you
-want to be used as the locale for the given user. In order to achieve the wanted locale
-configuration, you can set the locale which is defined for the user to the session right
-after the login. Fortunately, you can hook into the login process and update the user's
-session before the redirect to the first page. For this you need an event listener for the
-``security.interactive_login`` event:
+Let's pretend you have defined a ``locale"`` property on your ``User`` entity
+and you want to use this as the locale for the given user. To accomplish this,
+you can hook into the login process and update the user's session with the
+this locale value before they are redirected to their first page.
+
+To do this, you need an event listener for the ``security.interactive_login``
+event:
 
 .. code-block:: php
 
@@ -209,9 +210,6 @@ Then register the listener:
 
 .. caution::
 
-    With this configuration you are all set for having the locale based on the user's
-    locale. If however the locale changes during the session, it would not be updated
-    since with the current implementation the user locale will only be stored to the
-    session on login. In order to update the language immediately after a user has
-    changed their language, you need to update the session after an update to
-    the user entity.
+    In order to update the language immediately after a user has changed
+    their language preferences, you need to update the session after an update
+    to the ``User`` entity.