.. -*- 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