refines some docstrings