Enforce Numpy doc style

[felixhekhorn]

Following @alecandido s comment in eko on now we're trying to use Numpy doc style guide - actually, we could really enforce this by pre-commit using pydocstyle - shall we do this? @andreab1997 @alecandido @giacomomagni @niclaurenti

it would (most likely) be a major rework in eko (I'm guessing), so we could instead start it here: 21 issues

[alecandido]

Consider that pre-commit is working incrementally: it only applies to the files you changed in your commit.

[felixhekhorn]

that is to say: we should do it in any case and just increment?

[alecandido]

Yes, I would not try to make an enormous effort to standardize all at once: while touching the files with various changes, let's improve docstrings incrementall.

The moment we believe is almost fine, we will attempt to run pre-commit run --all-files

[felixhekhorn]

Introduced in 918f547 ; completed in 20e6c57

[alecandido]

So much the better.

If it's done, feel free to close the issue (or just wait for the PR to be merged).