Merge branch 'AndrewPashkin-clarify-level-of-separation-of-namespaces'

docs/index.rst

@@ -204,14 +204,14 @@ as a pathname following the hostname and port. For example, connecting to
 *http://example.com:8000/chat* would open a connection to the namespace
 */chat*.
 
-Each namespace is handled independently from the others, with separate event
+Each namespace is handled independently from the others, with separate session
-handlers and rooms. It is important that applications that use multiple
+IDs (``sid``s), event handlers and rooms. It is important that applications
-namespaces specify the correct namespace when setting up their event handlers
+that use multiple namespaces specify the correct namespace when setting up
-and rooms, using the optional ``namespace`` argument available in all the
+their event handlers and rooms, using the optional ``namespace`` argument
-methods in the :class:`socketio.Server` class.
+available in all the methods in the :class:`socketio.Server` class.
-
+
-When the ``namespace`` argument is omitted, set to ``None`` or to ``'/'``, the
+When the ``namespace`` argument is omitted, set to ``None`` or to ``'/'``, a
-default namespace, representing the physical connection, is used.
+default namespace is used.
 
 Class-Based Namespaces
 ----------------------