Releases · ropensci/dev_guide

08 Mar 13:49

maelle

v9.0.1

fbe99ea

9.0.1 Latest

Latest

2024-01-09, update roxygen2 wording (@vincentvanhees, #792).
2023-12-15, update roxygen2 advice, mainly linking to roxygen2 website (#750).
2023-09-15, add suggestions for API packages (#496).
Translation to Spanish!
2023-07-17, Update Aims and Scope to include translation packages, remove experimental text-processing categories, and provide clarifications around API wrappers
2023-05-04, Added link to Bioconductor book (#663, @llrs).
2023-04-26, Changed suggested lifecycle stage in authors guide (#661, @bart1).
2023-04-25, changed the COI section to use parallel construction (#659, @eliocamp).
2022-07-04, Add resources around GitHub workflows (#479, @maurolepore).
2023-02-14, update instructions for CITATION to reflect new CRAN policies (#604, #609).
2023-02-14, add package maintainer cheatsheet (#608).
2023-01-25, add Mastodon as social media (#592, by @yabellini).
2023-01-25, add Mastodon as social media (#592, by @yabellini).
2023-01-20, fix small formating error (#590 by @eliocamp).
2022-11-22, mention shinytest2 near shinytest.
2022-09-20, add editor instruction to add "stats" label to stats submissions
2022-09-20, fixed link to reviewer approval template (#548), and rendering of editor's template (#547)
2022-08-23, add recommendation to document argument default (@Bisaloo, #501)
2022-08-06, fix link to R Packages book (#498)
2022-07-21, mention GitHub Discussions and GitHub issue templates. (#482)
2022-07-21, highlight values for reviewing in more places (#481)
2022-07-20, Explanation of package submission via non-default branches (#485), added @s3alfisc to contributor list.
2022-07-20, add how to volunteer as a reviewer (#457).
2022-06-23, Expanded explanation of Codecov, added @ewallace to contributor list (#484)

Contributors

yabellini

Assets 2

07 Jun 09:57

mpadge

v0.8.0

aff4bcd

v0.8.0

2022-06-03, Remove former references to now-archived "rodev" package
2022-05-30, Advise that reviewers can also directly call @ropensci-review-bot check package
2022-05-27, Add Mark Padgham to list of authors
2022-05-27, Add devguider::prerelease_checklist item to pre-release template (#463)
2022-05-13, Align version number in DESCRIPTION file with actual version (#443)
2022-05-13, Update guidelines for CONTRIBUTING.md (#366, #462)
2022-05-09, Add section on authorship of included code, thanks to @KlausVigo (#388).
2022-05-09, Remove mention of 'rev' role requiring R v3.5
2022-05-05, Move all scripts from local inst directory to ropensci-org/devguider pkg.
2022-05-03, Update package archiving guidance to reduce README to minimal form.
2022-04-29, Advise that authors can directly call @ropensci-review-bot check package.
2022-04-29, Describe pkgcheck-action in CI section.
2022-04-29, Update scope in policies section to include statistical software.
2022-04-29, Add prelease.R script to open pre-release GitHub issue & ref in appendix.
2022-04-26, Add GitHub 2FA recommendation to package security.
2022-03-29, Remove references to Stef Butland, former community manager.
2022-03-28, Add comments on submission planning about time commitment.
2022-03-24, Remove approval comment template (coz it's automatically generated by the bot now).
2022-03-21, rephrase CITATION guidance to make it less strict. Also mentions CITATION.cff and the cffr package.
2022-03-08, add links to blogs related to package development (#389).
2022-02-17, update redirect instructions (@peterdesmet, #387).
2022-02-14, link to Michael Lynch's post Why Good Developers Write Bad Unit Tests.
2022-02-14, mention more packages for testing like dittodb, vcr, httptest, httptest2, webfakes.
2022-01-10, make review templates R Markdown files (@Bisaloo, #340).
2022-01-14, update guidance on CI services (#377)
2022-01-11, update guidance around branches, with resources suggested by @ha0ye and @statnmap.
2022-01-10, divide author's guide into sub-sections, and add extra info including pkgcheck.

2021-11-30, adds links to examples of reviews, especially tough but constructive ones (with help from @noamross, @mpadge, #363).
2021-11-19, add recommended spatial packages to scaffolding section (software-review-meta#47)
2021-11-18, update advice on grouping functions for pkgdown output (#361)

Assets 2

16 Nov 09:11

maelle

98ab585

v0.7.0

2021-11-04, add mentions of stat software review to software review intro and to the first book page (#342).
2021-11-04, mention pkgcheck in the author guide (@mpadge, #343).
2021-11-04, add editors' responsabilities including Editor etiquette for commenting on packages on which you aren't handling/reviewing (@jhollist, #354).
2021-11-04, give precise examples of tools for installation instructions (remotes, pak, R-universe).
2021-11-04, add more bot guidance (less work for editors).
2021-10-07, add guidance for editorial management (recruiting, inviting, onboarding, offboarding editors).
2021-09-14, add a requirement that there is at least one HTML vignette.
2021-09-03, add some recommendations around git. (@annakrystalli, #341)
2021-07-14, clarify the categories data extraction and munging by adding examples. (@noamross, #337)
2021-05-20, add guidance around setting up your package to foster a community, inspired by the recent rOpenSci community call. (with help from @Bisaloo, #289, #308)
2021-04-27, no longer ask reviewers to ask covr as it'll be done by automatic tools, but ask them to pay attention to tests skipped.
2021-04-02, add citation guidance.
2021-04-02, stop asking reviewers to run goodpractice as this is part of editorial checks.
2021-03-23, launched a new form for reviewer volunteering.
2021-02-24, add guidance around the use of @ropensci-review-bot.

Contributors

noamross, jhollist, and 2 other contributors

Assets 2

22 Feb 09:08

maelle

v6.0.0

a1afce5

v6.0.0

2021-02-04, add guidance to enforce package versioning and tracking of changes through review (@annakrystalli, #305)
2021-01-25, add a translation of the review template in Spanish (@Fvd, @maurolepore, #303)
2021-01-25, the book has now better citation guidance in case you want to cite this very guide (@Bisaloo, #304).
2021-01-12, add some more guidance on escaping examples (#290).
2021-01-12, mention the lifecycle package in the chapter about package evolution (#287).
2021-01-12, require overlap information is put in documentation (#292).
2021-01-12, start using the bookdown::bs4_book() template.
2021-01-12, add a sentence about whether it is acceptable to push a new version of a package to CRAN within two weeks of the most recent version if you have just been made aware of, and fixed, a major bug (@sckott, #283)
2021-01-12, mention the HTTP testing in R book.
2021-01-12, mention testthat snapshot tests.
2021-01-12, remove mentions of Travis CI and link to Jeroen Ooms' blog post about moving away from Travis.
2021-01-12, update the package curation policy: mention a possible exception for legacy packages that are vital parts of the R and/or rOpenSci package ecosystem which are actively monitored by staff. (@noamross, #293)

Assets 2

22 Feb 08:56

maelle

0.6.0

51e6642

0.6.0

2021-02-04, add guidance to enforce package versioning and tracking of changes through review (@annakrystalli, #305)
2021-01-25, add a translation of the review template in Spanish (@Fvd, @maurolepore, #303)
2021-01-25, the book has now better citation guidance in case you want to cite this very guide (@Bisaloo, #304).
2021-01-12, add some more guidance on escaping examples (#290).
2021-01-12, mention the lifecycle package in the chapter about package evolution (#287).
2021-01-12, require overlap information is put in documentation (#292).
2021-01-12, start using the bookdown::bs4_book() template.
2021-01-12, add a sentence about whether it is acceptable to push a new version of a package to CRAN within two weeks of the most recent version if you have just been made aware of, and fixed, a major bug (@sckott, #283)
2021-01-12, mention the HTTP testing in R book.
2021-01-12, mention testthat snapshot tests.
2021-01-12, remove mentions of Travis CI and link to Jeroen Ooms' blog post about moving away from Travis.
2021-01-12, update the package curation policy: mention a possible exception for legacy packages that are vital parts of the R and/or rOpenSci package ecosystem which are actively monitored by staff. (@noamross, #293)

Assets 2

21 Oct 11:03

maelle

0.5.0

ccc61e7

0.5.0

2020-10-08, add help about link checking (@sckott, #281)
2020-10-08, update JOSS instructions (@karthik, #276)
2020-10-05, add links to licence resources (@annakrystalli, #279)
2020-10-05, update information about the contributing guide (@stefaniebutland, #280)
2020-09-11, make reviewer approval a separate template (@bisaloo, #264)
2020-09-22, add package curation policy (@noamross, #263)
2020-09-11, add more guidance and requirements for docs at submission (@annakrystalli, #261)
2020-09-14, add more guidance on describing data source in DESCRIPTION (@mpadge, #260)
2020-09-14, add more guidance about tests of deprecated functions (@sckott, #213)
2020-09-11, update the CI guidance (@bisaloo, @mcguinlu, #269)
2020-09-11, improve the redirect guidance (@jeroen, @mcguinlu, #269)

Assets 2

12 Apr 12:46

maelle

devguide0.4.0

4a67a67

devguide0.4.0

2020-04-02, give less confusing code of conduct guidance: the reviewed packages' COC is rOpenSci COC (@Bisaloo, @cboettig, #240)
2020-03-27, add section on Ethics, Data Privacy and Human Subjects Research to Policies chapter
2020-03-12, mention GitHub Actions as a CI provider.
2020-02-24, add guide for inviting a guest editor.
2020-02-14, add mentions of the ropensci-books GitHub organisation and associated subdomain.
2020-02-10, add field and laboratory reproducibility tools as a category in scope.
2020-02-10, add more guidance about secrets and package development in the security chapter.
2020-02-06, add guidance about Bioconductor dependencies (#246).
2020-02-06, add package logo guidance (#217).
2020-02-06, add one CRAN gotcha: single quoting software names(#245, @aaronwolen)
2020-02-06, improve guidance regarding the replacement of "older" pkgdown website links and source (#241, @cboettig)
2020-02-06, rephrase the EiC role (#244).
2020-02-06, remove the recommendation to add rOpenSci footer (ropensci/software-review-meta#79).
2020-02-06, remove the recommendation to add a review mention to DESCRIPTION but recommends mentioning the package version when reviewers are added as "rev" authors.
2020-01-30, slightly changes the advice on documentation re-use: add a con; mention @includeRmd and @example; correct the location of Rmd fragments (#230).
2020-01-30, add more guidance for the editor in charge of a dev guide release (#196, #205).
2020-01-22, add guidance in the editor guide about not transferred repositories.
2020-01-22, clarify forum guidance (for use cases and in general).
2020-01-22, mention an approach for pre-computing vignettes so that the pkgdown website might get build on rOpenSci docs server.
2020-01-22, document the use of mathjax with rotemplate (@Bisaloo, #199).
2020-01-20, add guidance for off-thread interaction and COIs (@noamross, #197).
2020-01-20, add advice on specifying dependency minimum versions (@karthik, @annakrystalli, #185).
2020-01-09, start using GitHub actions instead of Travis for deployment.
-2019-12-11, add note in Documentation sub-section of Packaging Guide section about referencing the new R6 support in roxygen2 (#189)
2019-12-11, add new CRAN gotcha about having 'in R' or 'with R' in your package title (@bisaloo, #221)

Assets 2

24 Oct 13:43

maelle

0.3.0

d8247d6

0.3.0

2019-10-03, include in the approval template that maintainers should include link to the docs.ropensci.org/pkg site (#191)
2019-09-26, add instructions for handling editors to nominate packages for blog posts (#180)
2019-09-26, add chapter on changing package maintainers (#128) (#194)
2019-09-26, update Slack room to use for editors (#193)
2019-09-11, update instructions in README for rendering the book locally (#192)
2019-08-05, update JOSS submission instructions (#187)
2019-07-22, break "reproducibility" category in policies into component parts. (ropensci/software-review-meta#81)
2019-06-18, add link to rOpenSci community call "Security for R" to security chapter.
2019-06-17, fix formatting of Appendices B-D in the pdf version of the book (bug report by @IndrajeetPatil, #179)
2019-06-17, add suggestion to use R Markdown hunks approach when the README and the vignette share content. (#161)
2019-06-17, add mention of central building of documentation websites.
2019-06-13, add explanations of CRAN checks. (#177)
2019-06-13, add mentions of the rodev helper functions where relevant.
2019-06-13, add recommendation about using cat for str.*() methods. RStudio assumes that str uses cat, if not when loading an R object the str prints to the console in RStudio and doesn't show the correct object structure in the properties. ([@mattfidler] (https://github.com/mattfidler/) #178)
2019-06-12, add more details about git flow.
2019-06-12, remove recommendation about roxygen2 dev version since the latest stable version has what is needed. (@bisaloo, #165)
2019-06-11, add mention of usethis functions for adding testing or vignette infrastructure in the part about dependencies in the package building guide.
2019-06-10, use the new URL for the dev guide, https://devguide.ropensci.org/
2019-05-27, add more info about the importance of the repo being recognized as a R package by linguist (@bisaloo, #172)
2019-05-22, update all links eligible to HTTPS and update links to the latest versions of Hadley Wickham and Jenny Bryan's books (@bisaloo, #167)
2019-05-15, add book release guidance for editors. (#152)

Assets 2

13 May 08:00

maelle

0.2.0

98caea5

0.2.0

2019-05-13, add more content to the chapter about contributing.
2019-05-13, add more precise instructions about blog posts to approval template for editors.
2019-05-13, add policies allowing using either <- or = within a package as long as the whole package is consistent.
2019-05-13, add request for people to tell us if they use our standards/checklists when reviewing software elsewhere.
2019-04-29, add requirement and advice on testing packages using devel and oldrel R versions on Travis.
2019-04-23, add a sentence about why being generous with attributions and more info about ctb vs aut.
2019-04-23, add link to Daniel Nüst's notes about migration from XML to xml2.
2019-04-22, add use of rOpenSci forum to maintenance section.
2019-04-22, ask reviewer for consent to be added to DESCRIPTION in review template.
2019-04-22, use a darker blue for links (feedback by @kwstat , #138).
2019-04-22, add book cover.
2019-04-08, improve formatting and link text in README (@katrinleinweber, #137)
2019-03-25, add favicon (@wlandau, #136).
2019-03-21, improve Travis CI guidance, including link to examples. (@mpadge, #135)
2019-02-07, simplify code examples in Package Evolution section (maintenance_evolution.Rmd file) (@hadley, #129).
2019-02-07, added a PDF file to export (request by @IndrajeetPatil, #131).

Assets 2

01 Feb 05:41

maelle

0.1.3

9fea0c7

Update metadata

.zenodo.json and LICENCE

Assets 2

Releases: ropensci/dev_guide

9.0.1

Contributors

Uh oh!

v0.8.0

Uh oh!

v0.7.0

Contributors

Uh oh!

v6.0.0

Uh oh!

0.6.0

Uh oh!

0.5.0

Uh oh!

devguide0.4.0

Uh oh!

0.3.0

0.3.0

Uh oh!

0.2.0

0.2.0

Uh oh!

Update metadata

Uh oh!