[symfony#2562] Minor tweaks to session proxy article

weaverryan · weaverryan · commit fe0c7d777ad0 · 2013-05-03T22:53:33.000-06:00
diff --git a/cookbook/index.rst b/cookbook/index.rst
@@ -13,6 +13,7 @@ The Cookbook
     validation/index
     configuration/index
     service_container/index
+    session/index
     bundles/index
     email/index
     testing/index
diff --git a/cookbook/map.rst.inc b/cookbook/map.rst.inc
@@ -132,6 +132,10 @@
   * :doc:`/cookbook/service_container/scopes`
   * :doc:`/cookbook/service_container/compiler_passes`
 
+* :doc:`/cookbook/session/index`
+
+  * :doc:`/cookbook/session/proxy_examples`
+
 * **symfony1**
 
   * :doc:`/cookbook/symfony1`
diff --git a/cookbook/session/proxy_examples.rst b/cookbook/session/proxy_examples.rst
@@ -4,28 +4,26 @@
 Session Proxy Examples
 ----------------------
 
-The session proxy mechanism has a variety of uses, this
-example demonstrates two common uses. Rather than injecting
-the session handler as normal, a handler is injected into the proxy
-and registered with the session storage driver::
+The session proxy mechanism has a variety of uses and this example demonstrates
+two common uses. Rather than injecting the session handler as normal, a handler
+is injected into the proxy and registered with the session storage driver::
 
-    <?php
     use Symfony\Component\HttpFoundation\Session\Session;
     use Symfony\Component\HttpFoundation\Session\Storage\NativeSessionStorage;
     use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionStorage;
 
     $proxy = new YourProxy(new PdoSessionStorage());
     $session = new Session(new NativeSessionStorage($proxy));
 
-The examples below show elaborate on two use-cases.
+Below, you'll learn two real examples that can be used for ``YourProxy``:
+encryption of session data and readonly guest session.
 
 Encryption of Session Data
 --------------------------
 
-If you wanted to encrypt the session data you could use the proxy to encrypt
+If you wanted to encrypt the session data, you could use the proxy to encrypt
 and decrypt the session as required::
 
-    <?php
     use Symfony\Component\HttpFoundation\Session\Storage\Proxy\SessionHandlerProxy;
 
     class EncryptedSessionProxy extends SessionHandlerProxy
@@ -54,15 +52,13 @@ and decrypt the session as required::
         }
     }
 
-
-Readonly Guest sessions
+Readonly Guest Sessions
 -----------------------
 
-There are some applications where a session is required for guest
-users, but there is no particular need persist the session. In this
-case you can intercept the session before it writes::
+There are some applications where a session is required for guest users, but
+there is no particular need to persist the session. In this case you can
+intercept the session before it writes::
 
-    <?php
     use Foo\User;
     use Symfony\Component\HttpFoundation\Session\Storage\Proxy\SessionHandlerProxy;
 
@@ -86,4 +82,3 @@ case you can intercept the session before it writes::
             return parent::write($id, $data);
         }
     }
-
