Welcome to the R4DS Advanced R Book Club!
We are working together to read Advanced R by Hadley Wickham (Chapman & Hall, copyright 2019, 9780815384571). Join the #book_club-advr channel on the R4DS Slack to participate. As we read, we are producing notes about the book.
If you would like to present, please see the sign-up sheet for your cohort (linked below, and pinned in the #book_club-BOOKABBR channel on Slack)!
- Cohort 1 (started 2020-04-02, ended 2020-09-22): meeting videos
- Cohort 2 (started 2020-07-30, ended 2021-03-04): meeting videos
- Cohort 3 (started 2020-08-04, ended 2021-03-22): meeting videos
- Cohort 4 (started 2020-10-05, ended 2021-04-26): meeting videos
- Cohort 5 (started 2021-03-06, ended 2021-08-31): meeting videos
- Cohort 6 (started 2022-05-25): Wednesdays, 13:00 CST/CDT | meeting videos
The slides from the old clubs are in a separate repository.
This repository is structured as a {bookdown} site. To present, follow these instructions:
Do these steps once:
- Setup Github Locally (also see Happy Git and GitHub for the useR)
- Install {usethis} and {devtools}
install.packages(c("usethis", "devtools"))
- Set up a default {usethis} directory:
usethis::edit_r_profile()
to open your profile for editing.- Add this line:
options(usethis.destdir = "YOURDIR")
(replaceYOURDIR
with the root directory under which you want your R projects to appear; or you can skip these steps, and the project will be saved to your Desktop). - Restart your R session (Session/Restart R in Rstudio).
usethis::create_from_github("r4ds/bookclub-advr")
(cleanly creates your own copy of this repository).
Do these steps each time you present another chapter:
- Open your project for this book.
usethis::pr_init("my-chapter")
(creates a branch for your work, to avoid confusion, making sure that you have the latest changes from other contributors; replacemy-chapter
with a descriptive name, ideally).devtools::install_dev_deps()
(installs any packages used by the book that you don't already have installed).- Edit the appropriate chapter file, if necessary. Use
##
to indicate new slides (new sections). - If you use any packages that are not already in the
DESCRIPTION
, add them. You can useusethis::use_package("myCoolPackage")
to add them quickly! - Build the book! ctrl-shift-b (or command-shift-b) will render the full book, or ctrl-shift-k (command-shift-k) to render just your slide. Please do this to make sure it works before you push your changes up to the main repo!
- Commit your changes (either through the command line or using Rstudio's Git tab).
usethis::pr_push()
(pushes the changes up to github, and opens a "pull request" (PR) to let us know your work is ready).- (If we request changes, make them)
- When your PR has been accepted ("merged"),
usethis::pr_finish()
to close out your branch and prepare your local repository for future work. - Now that your local copy is up-to-date with the main repo, you need to update your remote fork. Run
gert::git_push()
or click thePush
button on theGit
tab of Rstudio.
When your PR is checked into the main branch, the bookdown site will rebuild, adding your slides to this site.