Ordination

Docstrings improvements that address issue #207 and should solve the points raised in #285.