improve docstrings a bit for new struct field