further improved documentation