utils: completed most of rest of docstrings

still need descriptions for parameters, returns