add doc & as-map functions