Update docs to fix Doxygen build warnings

[oruebel]

Fix #50

Update docstrings to fix warnings in Doxygen build

[stephprince]

Thanks for fixing those, looks good.

I'm wondering if we want to change the doxygen warnings to be errors so that the build will fail if the docstrings don't match the functions?

[oruebel]

I'm wondering if we want to change the doxygen warnings to be errors so that the build will fail if the docstrings don't match the functions?

I'd suggest we add a GitHub action to simply test whether the docs are building. This would be similar to the action for deploying the docs on GitHub Pages, but with warnings elevated to errors and without actually deploying the docs. IN this way we'll see the errors on every PR.