.. -*- coding: utf-8 -*-

Sessions

========

There are two kinds of sessions.

* `user sessions` are the most common: they are related to users and

  carry security checks coming with user credentials

* `internal sessions` have all the powers; they are also used in only a

  few situations where you don't already have an adequate session at

  hand, like: user authentication, data synchronisation in

  multi-source contexts

.. note::

  Do not confuse the session type with their connection mode, for

  instance : 'in memory' or 'pyro'.

[WRITE ME]

* authentication and management of sessions