I took some of the changes made by Linus to avoid a fastidious rebase. + updated the documentation doc.
LINUS: I tried to update doc-strings in axis object to be compliant with
https://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_numpy.html
@cyril.guilloud , @pancino maybe you want to have a look if you agree with this format.