Tuesday, February 23, 2021 From rOpenSci (https://ropensci.org/blog/2021/02/23/devguide-0.6.0/). Except where otherwise noted, content on this site is licensed under the CC-BY license.
rOpenSci Software Peer Review’s guidance is gathered in an online book and keeps improving! To find out what’s new in our dev guide 0.6.0, you can read the changelog, or this blog post for more digested information.
We have resumed activity after a break due to the COVID-19 crisis, but are being gentle with deadlines and timing, giving a lot of grace to all people involved. We’re all doing our best and rOpenSci is trying to be accommodating with schedules during this challenging period.
We’re extending our software review system to submissions in Spanish, as we had hinted to in a forum post and other venues! The first package to be reviewed in Spanish is censo2017 by Pachá (aka Mauricio Vargas Sepúlveda) that provides access to the 2017 Chilean Census. Editor Melina Vidoni is in charge of this review, the reviewers are Frans van Dunné and María Paula Caldas. Frans van Dunné most kindly translated our review template to Spanish! ¡Muchas gracias!
If you speak Spanish and would like to hear more about our software peer review system, check out the recording of the LatinR talks by package author Miguel Alvarez and editor Maëlle Salmon.
To help R users, we now require information about overlap with other packages be mentioned prominently in package docs. If there is potential overlap or confusion with other packages providing similar functionality or having a similar name, add a note in the README, main vignette and potentially the Description field of DESCRIPTION. Example in rtweet README, rebird README.
As regards documentation and CRAN-readiness, the guide now has updated tips around escaping examples.
To safe-guard examples (e.g. requiring authentication) to be run on CRAN you need to use \dontrun{}. However, for a first submission CRAN won’t let you have all examples escaped so. In this case you might add some small toy examples, or wrap example code in try(). Also refer to the @exampleIf tag present, at the time of writing, in roxygen2 development version.
The guidance around testing mentions two tools that might help package authors: the new snapshot tests in testthat; and the recently updated book “HTTP testing in R” by Scott Chamberlain and Maëlle Salmon.
We have now removed mentions to Travis CI in particular from the chapter about continuous integration, as we no longer recommend using the service.
We added a small but important note around CRAN releases in the Releasing chapter about a frequent conundrum for maintainers. CRAN does not like too frequent updates. That said, if you notice a major problem one week after a CRAN release, explain it in cran-comments.md and try releasing a newer version.
The chapter about package evolution now has a link to the lifecycle package that might be useful for communicating changes to users.
We added a small update to the package curation policy: it now mentions a possible exception for keeping legacy packages that are vital parts of the R and/or rOpenSci package ecosystem which are actively monitored by staff.
Last but not least, we will now more strongly enforce the use of a NEWS.md file to indicate the changes made during review, and will require the package version to be increased after review.
Did you notice the guide got a design refresh? ✨
We switched from bookdown::gitbook() to bookdown::bs4_book() that’s available in the development version of the bookdown package.
We enjoy having the general table of contents on the left and the table of contents for the current chapter on the right.
We also find searching more intuitive.
Another meta change is that thanks to Hugo Gruson, we provide clearer citation guidance in case you want to cite the guide itself in a scientific publication! We improved our Zenodo metadata, and use the zen4R package for creating a BibTex chunk in the dev guide.
cat("\n```bibtex\n")
zenodo <- zen4R::ZenodoManager$new(
token = Sys.getenv("ZENODO_TOKEN")
)
guide <- zenodo$getDepositionByConceptDOI("10.5281/zenodo.2553043")
guide$exportAsBibTeX("dev_citation")
cat(readLines("dev_citation_BibTeX.bib"), sep = "\n")
cat("\n```\n")
fs::file_delete("dev_citation_BibTeX.bib")
@software{ropensci_2021_4554776,
author = {rOpenSci and
Brooke Anderson and
Scott Chamberlain and
Laura DeCicco and
Julia Gustavsen and
Anna Krystalli and
Mauro Lepore and
Lincoln Mullen and
Karthik Ram and
Noam Ross and
Maëlle Salmon and
Melina Vidoni},
title = {{rOpenSci Packages: Development, Maintenance, and
Peer Review}},
month = feb,
year = 2021,
publisher = {Zenodo},
version = {0.6.0},
doi = {10.5281/zenodo.4554776},
url = {https://doi.org/10.5281/zenodo.4554776}
}
In this post we summarized the changes incorporated into our book “rOpenSci Packages: Development, Maintenance, and Peer Review” over the last months. We are thankful for all contributions that shaped this release. We are already working on the next version, such as improving guidance for encouraging package citations and wondering how prescriptive to be regarding HTTP testing.
