first draft of README

README.rst

@@ -115,7 +115,7 @@ Package sets and toolchains
 MPSD software releases
 ~~~~~~~~~~~~~~~~~~~~~~
 
-As ``explained in the MPSD HPC documentation <https://computational-science.mpsd.mpg.de/docs/mpsd-hpc.html#software>``__, we
+As `explained in the MPSD HPC documentation <https://computational-science.mpsd.mpg.de/docs/mpsd-hpc.html#software>`__, we
 label software releases available on the HPC using a naming scheme of the year
 (such as ``23``) and a letter starting from ``a``. There is an exception that
 the first available software version is ``dev-23a`` (starting with ``dev-`` to
@@ -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)
+
+
+