updating users api function stubs and documenting todos