first draft of README

README.rst

@@ -150,7 +150,7 @@ The ``mpsd-software-manager`` python package.
 - This needs a recent Python (3.9 or later).
 - Install via pip or pipx.
 
-  Pipx commands are::
+  Pipx commands are:
   
   - to install: ``pipx install git+https://gitlab.gwdg.de/mpsd-cs/mpsd-software-manager``
   - to update: ``pipx upgrade mpsd-software-manager``
@@ -161,3 +161,13 @@ The ``mpsd-software-manager`` python package.
   - Please check https://spack.readthedocs.io/en/latest/getting_started.html#system-prerequisites
 
 
+The compilation of the ``*-mpi`` toolchains needs linux headers installed. (TODO Add more detail.)
+
+Working example
+~~~~~~~~~~~~~~~
+
+We have a continuous integration example at XXX, that shows the complete
+compilation cycle (including compilation of Octopus). (TODO)
+
+
+