better docstrings... for some stuff

no issue associated with this work