Put the default value alongside the name of the option to improve readability

Author: javiereguiluz

cookbook/security/remember_me.rst

@@ -52,49 +52,47 @@ the session lasts using a cookie with the ``remember_me`` firewall option:
 
 The ``remember_me`` firewall defines the following configuration options:
 
-``key``
-    (default value: ``null``) The value used to encrypt the cookie's content.
-    It's common to use the ``secret`` value defined in the ``app/config/parameters.yml``
-    file.
-
-``name``
-    (default value: ``REMEMBERME``) The name of the cookie used to maintain the
-    user logged in. If you enable the "Remember Me" feature in several firewalls
-    of the same application, make sure to choose a different name for the cookie
-    of each firewall. Otherwise, you'll face lots of security related problems.
-
-``lifetime``
-    (default value: ``31536000``) The number of seconds during which the user
-    will remain logged in. By default users are logged in for one year.
-
-``path``
-    (default value: ``/``) The path where the cookie associated with this
-    feature is used. By default the cookie will be applied to the entire website
-    but you can restrict to a specific section (e.g. ``/forum``, ``/admin``).
-
-``domain``
-    (default value: ``null``) The domain where the cookie associated with this
-    feature is used. By default cookies use the current domain obtained from
-    ``$_SERVER``.
-
-``secure``
-    (default value: ``false``) If ``true``, the cookie associated with this
-    feature is sent to the user through an HTTPS secure connection.
-
-``httponly``
-    (default value: ``true``) If ``true``, the cookie associated with this
-    feature is accessible only through the HTTP protocol. This means that the
-    cookie won't be accessible by scripting languages, such as JavaScript.
-
-``remember_me_parameter``
-    (default value: ``_remember_me``) The name of the form field checked to
-    decide if the "Remember Me" feature should be enabled or not. Keep reading
-    this article to know how to enable this feature conditionally.
-
-``always_remember_me``
-    (default value: ``false``) If ``true``, the value of the ``remember_me_parameter``
-    is ignored and the "Remember Me" feature is always enabled, regardless of the
-    desire of the end user.
+``key`` (default value: ``null``)
+    The value used to encrypt the cookie's content. It's common to use the
+    ``secret`` value defined in the ``app/config/parameters.yml`` file.
+
+``name`` (default value: ``REMEMBERME``)
+    The name of the cookie used to maintain the user logged in. If you enable the
+    "Remember Me" feature in several firewalls of the same application, make sure
+    to choose a different name for the cookie of each firewall. Otherwise, you'll
+    face lots of security related problems.
+
+``lifetime`` (default value: ``31536000``)
+    The number of seconds during which the user will remain logged in. By default
+    users are logged in for one year.
+
+``path`` (default value: ``/``)
+    The path where the cookie associated with this feature is used. By default
+    the cookie will be applied to the entire website but you can restrict to a
+    specific section (e.g. ``/forum``, ``/admin``).
+
+``domain`` (default value: ``null``)
+    The domain where the cookie associated with this feature is used. By default
+    cookies use the current domain obtained from ``$_SERVER``.
+
+``secure`` (default value: ``false``)
+    If ``true``, the cookie associated with this feature is sent to the user
+    through an HTTPS secure connection.
+
+``httponly`` (default value: ``true``)
+    If ``true``, the cookie associated with this feature is accessible only
+    through the HTTP protocol. This means that the cookie won't be accessible
+    by scripting languages, such as JavaScript.
+
+``remember_me_parameter`` (default value: ``_remember_me``)
+    The name of the form field checked to decide if the "Remember Me" feature
+    should be enabled or not. Keep reading this article to know how to enable
+    this feature conditionally.
+
+``always_remember_me`` (default value: ``false``)
+    If ``true``, the value of the ``remember_me_parameter`` is ignored and the
+    "Remember Me" feature is always enabled, regardless of the desire of the
+    end user.
 
 Forcing the User to Opt-Out of the Remember Me Feature
 ------------------------------------------------------