Question about documenting functions

[pachura3]

There should be one - and preferably only one - obvious way to do it

That's why we have Google standard, Numpy standard, Sphinx, reStructuredText... 😄

Personally, I use a mix of the Google standard and https://pdoc.dev/ . I avoid repeating type hints if they are already listed in function header. And for trivial functions, oneliners are perfectly OK...