diff --git a/README.rst b/README.rst
index ecd832701a739cbfbe2deee0cd86afc2e2c9596e..c29a590af31b643b3ae901c564f33e9789b51a94 100644
--- a/README.rst
+++ b/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)
+
+
+