Fix docs build (#480)

* Fix docs build

* Update what warnings we are looking for

* Change broken link

* Docstring fixes

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* Don't add mypy

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: jsignell