document map functions