improve docblock comments