add doc to explain arrow dimensions