fleshed out docs; added testing for exposed util functions