improved docstring/comment