.. warning::

   This documentation needs work (as discussed during the Gothenburg sprint in 2011)
