improved docblock