Fail in CI if NAMESPACE or Roxygen docs are out of date

[keller-mark]

User story

Even though these are a bit redundant to commit to the repo, I think they are needed for installation from github or from source to work properly.

Preferred solution

Fail in CI if NAMESPACE or Roxygen docs are out of date (e.g., if devtools::document() results in modified files).

Possible alternatives

Add a github actions workflow to automatically commit corrected files back to the main branch

[dblodgett-usgs]

Interesting use case -- do you know of any packages that do this? Mine do not. I rebuild roxygen when I build / install and always check in synced up documentation and namespace.