[symfony#2670] Tweaks to new entry about session save path with several tweaks thanks to @wouterj

weaverryan · weaverryan · commit 4b8a70bd18e8 · 2013-06-30T14:42:54.000-05:00
diff --git a/cookbook/map.rst.inc b/cookbook/map.rst.inc
@@ -137,6 +137,7 @@
 
   * :doc:`/cookbook/session/proxy_examples`
   * :doc:`/cookbook/session/locale_sticky_session`
+  * :doc:`/cookbook/session/sessions_directory`
 
 * **symfony1**
 
diff --git a/cookbook/session/sessions_directory.rst b/cookbook/session/sessions_directory.rst
@@ -1,50 +1,47 @@
 .. index::
    single: Sessions, sessions directory
 
-Configuring Sessions Directory
-==============================
+Configuring the Directory where Sessions Files are Saved
+========================================================
 
 By default, Symfony stores the session data in the cache directory. This
 means that when you clear the cache, any current sessions will also be
 deleted.
 
-Using a different directory to save session data is one method of retaining
-current sessions during a clearing of the cache.
+Using a different directory to save session data is one method to ensure
+that your current sessions aren't lost when you clear Symfony's cache.
 
 .. tip::
 
     Using a different session save handler is an excellent (yet more complex)
     method of session management available within Symfony. See
-    :doc:`/components/http_foundation/session_configuration.rst` for a
-    discussion of session save handlers.
+    :doc:`/components/http_foundation/session_configuration` for a
+    discussion of session save handlers. There is also an entry in the cookbook
+    about storing sessions in the :doc:`database</cookbook/configuration/pdo_session_storage>`.
 
 To change the directory in which Symfony saves session data, you only need
-change the framework configuration.  In this example, we are changing the
-session directory to 'app/sessions':
+change the framework configuration.  In this example, you will change the
+session directory to ``app/sessions``:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
         # app/config/config.yml
-
         framework:
             session:
-                save_path: %kernel.root_dir%/sessions
+                save_path: "%kernel.root_dir%/sessions"
 
     .. code-block:: xml
 
         <!-- app/config/config.xml -->
-
         <framework:config>
             <framework:session save-path="%kernel.root_dir%/sessions" />
         </framework:config>
 
     .. code-block:: php
 
         // app/config/config.php
-
         $container->loadFromExtension('framework', array(
             'session' => array('save-path' => "%kernel.root_dir%/sessions"),
         ));
-
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
@@ -252,9 +252,11 @@ save_path
 **type**: ``string`` **default**: ``%kernel.cache.dir%/sessions``
 
 This determines the argument to be passed to the save handler. If you choose
-the default file handler, this is the path where the files are created. You can
-also set this value to the ``save_path`` of your ``php.ini`` by setting the
-value to ``null``:
+the default file handler, this is the path where the session files are created.
+For more information, see :doc:`/cookbook/session/sessions_directory`.
+
+You can also set this value to the ``save_path`` of your ``php.ini`` by setting
+the value to ``null``:
 
 .. configuration-block::
 
