jz1584/what-they-forgot

What They Forgot To Teach You About R, workshop homepage

What They Forgot to Teach You About R

Shortlinks and downloads:

• rstd.io/forgot points here
• rstd.io/forgot_gitter is our chat room (ignore if you are overstimulated already)
• The issues here are a great place to record gotchas we encountered, good sidebar discussions, etc. that should be considered in future workshops.

Day 1, morning

• Download PDF of of slides re: projects, file system operations, file names
• usethis::use_course("rstd.io/forgot_1") downloads first challenge re: exploring your package libraries
  • If you have trouble connecting to DropBox, the same files are here in the directory day1_s1_explore-libraries
• usethis::use_course("rstd.io/forgot_2") downloads second challenge re: working with the filesystem programmatically - If you have trouble connecting to DropBox, the same files are here in the directory day1_s2_copy-files

Day 1, afternoon

• Download PDF of slides re: Git + GitHub + R/Rmd
• Happy Git with R
  • Participants and helpers should use this as primary resource for Git/GitHub setup and troubleshooting
  • This is also the permanent home of many of the activities we worked through, Git/GitHub topics covered, etc.
  • Issues are welcome here as well re: sections that should be added.

Day 2, morning

• Download PDF of slides re: how to exploit the active R scene on GitHub by Jim Hester
• General Q & A re: GitHub habits and etiquette.
• Discuss issue about updating / reinstalling packages after updating R. General Q & A re: maintaining one's R installation. Startup files.
  • GitHub search for dotfile repos!
  • Kevin Ushey blog post on .Rprofile RProfile Essentials
  • Kevin's etc repo for dotfiles and the like
  • Shaun Jackman's dotfiles repo
  • Jim Hester's dotfiles repo
• Download PDF of slides re: project subdirectories & choreography, a humane API for an analysis, and the here package
  • Link to GitHub repo you will fork, clone, and develop during the challenge: rstd.io/forgot_3
  • One possible solution (don't peek!) rstd.io/forgot_4

Day 2, afternoon

• Finish morning challenge and debrief
• Kirill Müller to share a preview of Make-like packages for R work
• Discuss file and directory naming (was skipped on Day 1 due to time)
• Download PDF of slides on iterating with purrr
• Much bigger set of purrr explainers and tutorials: https://jennybc.github.io/purrr-tutorial/index.html
• Live code demo of purrr
  • rstd.io/jenny-live-code
  • Version at the start (has gaps for challenges) purrr-live-coding.R
  • Version at the end (everything filled in) Jenny to copy her final version here after the live code segment is done
• Prompts for Choose Your Own Adventure: prompts.md
• During Choose Your own Adventure, also assume it's "office hours" w/ Jenny, Kirill, Lucy, Jim. Show us your weird R stuff!
• Examples that draw on many workshop themes
  • Clickable gallery of O'Reilly book cover parodies, forked from thepracticaldev/orly-full-res
  • Fattest cat, finds the fattest cat currently up for adoption as SF SPCA. Translated from the original Javascript.
• Wrap up not sure if I'll post slides, most will be repeats

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

Installing the fs package on macOS

fs is a new package from Jim Hester that for managing files and directories that I will use throughout the workshop.

The CRAN mirrors are currently having trouble with macOS binaries. If you are on mac you can install the fs package with a binary for the current CRAN release (1.1.0):

url <- "https://github.com/jennybc/what-they-forgot/blob/master/fs_1.1.0.tgz?raw=true"
install.packages(url, repos = NULL, type = "binary")

There is also a binary available for the current development version of fs.

install.packages("https://github.com/r-lib/fs/releases/download/1.1.0.9000/fs_1.1.0.9000.tgz")

Fixing slow CRAN downloads

We have set up a local CRAN mirror for the RStudio conference. All requests to https://cran.rstudio.com/ are intercepted and redirected to this local mirror in order to improve download speeds. Make sure your default CRAN repo is set to the RStudio mirror (this is the default if you use RStudio):

options(repos = c(CRAN = "https://cran.rstudio.com/"))