Contributing:
First, thanks for considering a contribution! I hope to make this package a community created resource for us all to gain from and won’t be able to do that without your help!
- Contributions should be thoroughly tested with testthat.
- Code style should attempt to follow the tidyverse style guide.
- Please attempt to describe what you want to do prior to contributing by submitting an issue.
- Please follow the typical github fork - pull-request workflow.
- Make sure you use roxygen and run Check before contributing. More on this front as the package matures.
-
hydroloomuses tidyselection and data masking. Please review the list ofhydroloomglobal attribute inR/00_hydroloom.Rbefore contributing. They are used as package variables in tidy selection broadly.
Vignettes and articles:
vignettes/hydroloom.Rmd is the only vignette that ships to CRAN. Everything under vignettes/articles/ is website-only and is excluded from the source tarball. A new vignette that needs a web service, a large download, or a heavy suggested package belongs in vignettes/articles/; a self-contained one that uses only the data in inst/extdata can go either place.
Every vignette gates chunk evaluation on BUILD_VIGNETTES:
local <- (Sys.getenv("BUILD_VIGNETTES") == "TRUE")
knitr::opts_chunk$set(eval = local)Set BUILD_VIGNETTES=TRUE in a local .Renviron to render with live code. New vignettes should follow the same pattern. Because articles are not installed, do not refer to them with vignette("name") — use a link to the pkgdown page instead.
The build and release process is described in the README under “Build and release.”
Other notes: - consider running lintr prior to contributing. - consider running goodpractice::gp() on the package before contributing. - consider running devtools::spell_check() if you wrote documentation. - this package uses pkgdown. Running pkgdown::build_site() will refresh it.
