documentation done
minor docstring changes