improved documentation and fixed email link