MAINT: restore optional ravel order and add tests and more docstring lines