R4DS R for Data Science Book Club
Welcome to the R4DS R for Data Science Book Club! This is a new experimental repository, separate from the main R4DS R4DS repository.
We are working together to read R for Data Science by Hadley Wickham, Mine Çetinkaya-Rundel, and Garrett Grolemund. Join the #book_club-r_for_data_science channel on the R4DS Slack to participate. As we read, we are producing notes about the book.
Meeting Schedule
If you would like to present, please see the sign-up sheet for your cohort (linked below, and pinned in the #book_club-r4ds channel on Slack)!
- Cohort 1 (started 2020-07-31, ended 2020-10-12): meeting videos
- Cohort 2 (started 2020-08-03, ended 2021-03-29): meeting videos
- Cohort 3 (started 2020-12-08, ended 2021-11-09): meeting videos
- Cohort 4 (started 2020-12-16, ended 2021-06-23): meeting videos
- Cohort 5 (started 2021-07-24, ended 2022-04-23): meeting videos
- Cohort 6 (started 2021-10-15): Thursdays, 11:30am CST/CDT | meeting videos
- Cohort 7 (starts 2022-08-29): Mondays, 11:00am CST/CDT | meeting videos
- Cohort 8 (start date TBD): TBD, TBD CST/CDT | meeting videos
How to Present
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-r4ds")
(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("origin")
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.