clarify docstrings for to-vector and as-vector