some much needed updates to docs using roxygen 4.0.0