testing function is working, pending documentation