From 651ef840c8ec1f86b458b4e5e625599b783ba96f Mon Sep 17 00:00:00 2001
From: Ralf Ulrich <ralf.ulrich@kit.edu>
Date: Fri, 2 Oct 2020 01:16:16 +0200
Subject: [PATCH] Update README.md

---
 README.md | 49 +++++++++++++++++++++++++++++++++++++++++--------
 1 file changed, 41 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 497e4f239..fb4dc7c69 100644
--- a/README.md
+++ b/README.md
@@ -50,7 +50,10 @@ which are very useful also for us.
     touch with the project
 
 
-## Prerequisites
+
+## Installation (from source)
+
+### Prerequisites
 
 CORSIKA 8 is tested regularly via gitlab-CI using recent gcc and clang
 versions.  Additional software prerequisites: cmake, g++, git.
@@ -72,10 +75,9 @@ pkg install git cmake python3 flang
 ```
 or add ```boost-libs``` and ```eigen``` if you want to use the system versions. 
 
-## Installation
-
+### Compiling
 
-Follow these steps to download and install CORSIKA 8 milestone2
+Follow these steps to download and install CORSIKA 8, master development version
 ```
 git clone --recursive https://gitlab.ikp.kit.edu/AirShowerPhysics/corsika.git
 cd corsika
@@ -84,9 +86,39 @@ cd ../corsika-build
 cmake ../corsika -DCMAKE_INSTALL_PREFIX=../corsika-install
 make -j8
 make install
-make test
 ```
-and if you want to see how the first simple hadron cascade develops, 
+
+Type `make test` to run the unit test suite.
+
+## Installation (using docker containers)
+
+There are docker containers prepared that bring all the environment and packages you need to run CORSIKA. See [docker hub](https://hub.docker.com/repository/docker/corsika/devel) for a complete overview. 
+
+### Prerequisites
+
+You only need docker, e.g. on Ubunut: `sudo apt-get install docker` and of course root access.
+
+## Compiling
+
+Follow these steps to download and install CORSIKA 8, master development version
+```
+git clone --recursive https://gitlab.ikp.kit.edu/AirShowerPhysics/corsika.git
+cd corsika
+sudo docker run -v $PWD:/corsika -it corsika/devel:clang-8 /bin/bash
+mkdir build
+cd build
+cmake .. -DCMAKE_INSTALL_PREFIX=../install
+make -j8
+make install
+```
+
+Type `make test` to run the unit test suite.
+
+## Running, Examples
+
+There are various examples in the folder `Documentation/Examples`. 
+
+If you want to see how the first simple hadron cascade develops, 
 see `Documentation/Examples/cascade_example.cc` for a starting point. 
 
 Run the cascade_example with: 
@@ -101,13 +133,14 @@ bash share/tools/plot_tracks.sh tracks.dat
 firefox tracks.dat.gif 
 ```
 
-Or also consider the `vertical_eas` example in the same directory, which can 
+Or also consider the `vertical_EAS` example in the same directory, which can 
 be configured with command line options. 
 
 
 ### Generating doxygen documentation
 
-To generate the documentation, you need doxygen and graphviz. On Ubuntu 18.04, do:
+To generate the documentation, you need doxygen and graphviz. If you work with the docker corsika/devel containers this is already included. 
+Otherwise, e.g. on Ubuntu 18.04, do:
 ```
 sudo apt-get install doxygen graphviz
 ```
-- 
GitLab