improve layout and some docs

this MR implements some changes after a first run together with @markus.benninghoff and @bjoern.sass.

@bjoern.sass, please have a look on the changes. you can also run this notebook following this link