[#1357] add doc strings, auth functions, more tests