Extract documentation from docstrings for better maintenance

[danrgll]

Automatically generate documentation directly from docstrings wherever possible using e.g. mkdocstrings, aiming to keep documentation up-to-date with the codebase and reducing the need for separate documentation efforts.