From 2aa8636223d714b1c87323f625645a433ac7e010 Mon Sep 17 00:00:00 2001
From: Miguel Grinberg <miguel.grinberg@gmail.com>
Date: Sat, 29 Jun 2019 10:10:06 +0100
Subject: [PATCH] documentation on user session behavior on disconnections
 (Fixes #308)

---
 docs/server.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/server.rst b/docs/server.rst
index de8d389..3f169e9 100644
--- a/docs/server.rst
+++ b/docs/server.rst
@@ -396,7 +396,6 @@ retrieve information in the user session::
 
 For the ``asyncio`` server, these methods are coroutines::
 
-
     @sio.event
     async def connect(sid, environ):
         username = authenticate_user(environ)
@@ -437,6 +436,10 @@ The ``get_session()``, ``save_session()`` and ``session()`` methods take an
 optional ``namespace`` argument. If this argument isn't provided, the session
 is attached to the default namespace.
 
+Note: the contents of the user session are destroyed when the client
+disconnects. In particular, user session contents are not preserved when a
+client reconnects after an unexpected disconnection from the server.
+
 Using a Message Queue
 ---------------------