docs. update documentation

Signed-off-by: Christoph Auer <cau@zurich.ibm.com>