improved documentation #22