Updated documentation based on great contribution from Werner Beroux from Switzerland