updated docstrings for easier formatting on things like RTDs