Add pydoclint pre-commit hook

[zaneselvans]

Overview

Adds a docstring linter to our pre-commit hooks.

It seems like it primarily lints for adherence to the Google (in our case) or NumPy docstring formatting conventions, and doesn't seem to look for RST errors, of which we have many.

Currently there are hundreds of errors, and we would need to tweak the configuration and/or save a "baseline" so that we can deal with the backlog of issues at our leisure.

• Save a "baseline" of docstring errors to address later
• Open an issue in the pydoclint repo about the crash on pudl.transform.ferc1
• Experiment with additional configuration options in pyproject.toml
• Look for an RST-specific docstring linter/formatter
• Review the PR yourself and call out any questions or issues you have.