support `mkdocstrings` kwargs documentation

[gegnew]

Following mkdocstrings/mkdocstrings#205 and as soon as mkdocstrings/mkdocstrings#331 is merged, we can document keyword arguments automatically, making some of our long docstrings less unwieldy