improve docstrings

3 jobs for new_algorithm_structure in 3 minutes and 52 seconds (queued for 3 seconds)