Upkeep for ggplot2 (2024)

[teunbrand]

To begin

• pr_init("upkeep-2024-10")

Pre-history

• usethis::use_readme_rmd()
• usethis::use_roxygen_md()
• usethis::use_github_links()
• usethis::use_pkgdown_github_pages()
• usethis::use_tidy_github_labels()
• usethis::use_tidy_style()
• urlchecker::url_check()

2020

• usethis::use_package_doc()
• usethis::use_testthat(3)
• Align the names of R/ files and test/ files

2021

• Remove check environments section from cran-comments.md
• Use lifecycle instead of artisanal deprecation messages

2022

• Handle and close any still-open master --> main issues
• usethis:::use_codecov_badge("tidyverse/ggplot2")
• Update pkgdown site using instructions at https://tidytemplate.tidyverse.org
• Update lifecycle badges with more accessible SVGs: usethis::use_lifecycle()

2023

• Update copyright holder in DESCRIPTION: person("Posit Software, PBC", role = c("cph", "fnd"))
• Run devtools::document() to re-generate package-level help topic with DESCRIPTION changes
• usethis::use_tidy_logo(); pkgdown::build_favicons(overwrite = TRUE)
• usethis::use_tidy_coc()
• Modernize citation files; see updated use_citation()
• Use pak::pak("tidyverse/ggplot2") in README
• Consider running usethis::use_tidy_dependencies() and/or replace compat files with use_standalone()
• Use cli errors or file an issue if you don't have time to do it now
• usethis::use_standalone("r-lib/rlang", "types-check") instead of home grown argument checkers;
  or file an issue if you don't have time to do it now
• Add alt-text to pictures, plots, etc; see https://posit.co/blog/knitr-fig-alt/ for examples

2024

• Review pkgdown output to find missing alt-text
• Switch to new quarto chunk style: Standardise on new quarto chunk style r-lib/usethis#1913
• Switch to expect_snapshot(error = TRUE) for class-less expect_error(): Convert expect_error() calls that don't use class r-lib/usethis#1918
• Record upkeep date (Record last upkeep year r-lib/usethis#1916)

To finish

• usethis::use_mit_license()
• usethis::use_package("R", "Depends", "4.0")
• usethis::use_tidy_description()
• usethis::use_tidy_github_actions()
• devtools::build_readme()
• Re-publish released site if needed

^{Created on 2024-10-24 with usethis::use_tidy_upkeep_issue(), using usethis v3.0.0.9000}

[teunbrand]

Why I didn't tick some bullets:

• usethis::use_readme_rmd()
  • This just initialised an empty readme, which is worse than the current readme
• usethis::use_pkgdown_github_pages()
  • Current setup seems to work fine
• usethis::use_tidy_style()
  • Loses some alignments around <- or = operators.
• Modernize citation files; see updated use_citation()
  • This just initialises an empty citation file, which is worse than the current one. Besides, I don't know what there is to be modernised.
• Consider running usethis::use_tidy_dependencies() and/or replace compat files with use_standalone()
  • I think we have the dependencies/compat files we need, no need to import spurious ones.