clean up docstrings

[eacharles]

https://lsstdescrail.readthedocs.io/en/latest/api.html

[drewoldag]

Ensure that each of the methods have doc strings that are accurate - not copy/pasted - and render correctly. We should reach out to the owners, this isn't necessarily something we need to write.

We should probably try to do this when there aren't a lot of moving parts.

[drewoldag]

@delucchi-cmu can you find the tool to automatically flag docstring problems?

[delucchi-cmu]

https://www.pydocstyle.org/en/stable/usage.html

This tool mostly surfaces formatting issues, but can also find public methods with no docstrings. Attached the findings from the package, cleaned up into a CSV, so you can look by file, or by error code.
docstring_findings.csv