Tweak docstrings to fix rendered docs

[ml-evs]

In a similar vein to materialsproject/api#863, this PR makes several docstring fixes that are otherwise breaking the rendered mkdocs, making it quite hard for users to use the API without digging into the code.

• Enable D411 ruff rule in pre-commit to ensure that sections are properly demarcated
• Fix D415 missing punctuation at end of summary so that docstring formats get properly detected
• Manually fix some broken docstrings in cases where indented code was erroneously treated as code snippets

Example from deployed docs:

Which will now look like:

There are still hundreds of pydocstyle warnings but I think this at least fixes the ones that mkdocs(trings) will care about.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (53867d9) 81.56% compared to head (60d2622) 81.56%.
Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #923   +/-   ##
=======================================
  Coverage   81.56%   81.56%           
=======================================
  Files          46       46           
  Lines        3938     3938           
=======================================
  Hits         3212     3212           
  Misses        726      726           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[rkingsbury]

Thanks very much @ml-evs !