Add autodoc_default_options to inherit docstrings

[quentinblampey]

Closes #828

I set the following defaults for the autodoc. The first interesting thing is that 'inherited-members': True fixes #828 because it will now show the inherited docstrings. The second thing is that 'members': True significantly cleans up the docs because I can remove it everywhere else.

autodoc_default_options = {
    'members': True,
    'inherited-members': True,
    'show-inheritance': True,
}

Note that I also removed :undoc-members:, because I don't think we should show methods that are not documented (it adds a lot of unreadable sections). But feel free to add it in the defaults if you prefer to have it @LucaMarconato

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 91.72%. Comparing base (f209018) to head (743535b).
Report is 5 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #830   +/-   ##
=======================================
  Coverage   91.72%   91.72%           
=======================================
  Files          46       46           
  Lines        7166     7166           
=======================================
  Hits         6573     6573           
  Misses        593      593