document functions that work