Update function/class/method docstrings

[bdamele]

Update function/class/method docstrings (where applicable)

[stamparm]

This is an open-ended maintenance intent with no acceptance criteria, so it cannot be tracked to completion as an issue. Docstring improvements are made inline alongside the code they touch. Closing as not actionable.