Thanks for your interest in contributing to workflowr. Here are some guidelines to help make it easier to merge your Pull Request:
devtools::test()to run the tests
If you’re new to submitting Pull Requests, please read the section Contribute to other projects in the tutorial A quick introduction to version control with Git and GitHub.
|master||stable branch for end users|
|dev||development branch - submit Pull Requests here|
For the most part, I try to follow the guidelines from R packages by Hadley Wickham. The unit tests are performed with testthat, the documentation is built with roxygen2, the online package documentation is created with pkgdown, continuous integration testing is performed for Linux and macOS by Travis CI and for Windows by AppVeyor, and code coverage is calculated with covr and Codecov.
The template files used by
wflow_start() to populate a new project are defined in the list
templates in the file
R/infrastructure.R. The RStudio project template is configured by
inst/rstudio/templates/project/wflow_start.dcf. The repository contains the files
LICENSE.md to both adhere to R package conventions for defining the license and also to make the license clear in a more conventional manner (suggestions for improvement welcome).
document.R is a convenience script for regenerating the documentation.
build.sh is a convenience script for running
R CMD check. The remaining directories are standard for R packages as described in the manual Writing R Extensions.
git logand make sure to reference GitHub Issues/PRs
git commit -am "Bump version: x.x.x.9xxx -> x.x.x and re-build docs."
git push origin devand wait for CI builds to pass
git checkout master git merge dev git push origin master
git tag -a vx.x.x. Summarize NEWS.md entry into bullet points. Run
git tag -l -n9for past examples. Push with
git push origin --tags.
R CMD build .and upload to CRAN submission site. You will receive an email to request confirmation, then an email confirming the package was submitted, and then an email with the test results. Once it is accepted to CRAN, monitor the check results for any surpise errors. Also, these builds are when the binaries are built for Windows and macOS, so they aren’t available until they are finished. You will receive an email once all the Windows binaries are available for download (devel, release, oldrel).