improve docstrings for variables