DOCFIX: clarify docstrings and output vertex dimension ordering