document new helpers