documentation review
Closed this issue · 0 comments
Good documentation is important for end users and is a good place to start when learning a new package. The MazamaCoreUtils package is taking on increasing importance as a solid base from which we build other packages and utilities.
This first task encourages you to become very familiar with this package by reviewing all function documentation and vignettes for typos and poor wording. It is also an opportunity to become familiar with the mechanics of building and testing a package, using git to add-commit-push changes and using Github to submit a pull request.
Documentation for the current development version of MazamaCoreUtils is available at:
https://mazamascience.github.io/MazamaCoreUtils/index.html
The specific component tasks are:
-
git clone https://github.com/MazamaScience/MazamaCoreUtils.git
and create akayleigh
branch to do your work - create a local version of the web docs by running
devtools::check()
and thenpkgdown::build_site()
- Copy edit the web version of the function reference documentation looking for typos, mistakes and poor wording.
- Make your edits, recheck and rebuild the site until the documentation is error free
- Repeat this process with the vignettes
- add-commit-push your changes to the
kayleigh
branch and submit a pull request