no implementation details in generic docstring

this made the docstring very long, just put it separate
adjust wording
shorter name for distance matrix function
add TODO
move imports to top
don't export cut_extrema()
remove unnecessary function elastic_bands()