improve docblock