From 70e922e20e6ec0f9bf2dd43c5db4c856301797c8 Mon Sep 17 00:00:00 2001 From: Ian Lyttle Date: Sun, 27 Aug 2023 18:28:02 -0500 Subject: [PATCH 1/3] reformat config, add titles --- _quarto.yml | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/_quarto.yml b/_quarto.yml index 8cc95e3..d678ac5 100644 --- a/_quarto.yml +++ b/_quarto.yml @@ -5,8 +5,6 @@ execute: echo: true warning: false - - website: title: "From R User to R Programmer" navbar: @@ -22,22 +20,23 @@ website: - text: --- - text: Functions - text: --- - - text: "👋 & Functions part 1" + - text: "👋 & Functions Part 1" href: 01-functions-01.qmd - - text: "something 2" + - text: "Functions Part 2" href: 02-functions-02.qmd - text: --- - text: Iteration - text: --- - - text: "something 3" + - text: "Iteration Part 1" href: 03-iteration-01.qmd - - text: "something 4" + - text: "Iteration Part 2" href: 04-iteration-02.qmd format: html: theme: cosmo css: styles.css toc: true + comments: hypothesis: true From 6f4cca68a330a367b1f43c38a31b9e92a8de5f04 Mon Sep 17 00:00:00 2001 From: Ian Lyttle Date: Sun, 27 Aug 2023 18:39:10 -0500 Subject: [PATCH 2/3] update pre-reqs --- index.qmd | 12 +++++------- pre-reqs.qmd | 19 +++---------------- 2 files changed, 8 insertions(+), 23 deletions(-) diff --git a/index.qmd b/index.qmd index 8e28aec..7dc931f 100644 --- a/index.qmd +++ b/index.qmd @@ -7,8 +7,8 @@ title: "From R User to R Programmer" by Emma Rand and Ian Lyttle 🗓️ September 18, 2023\ -⏰ 09:00 - 17:00\ -🏨 ROOM TBD\ +⏰ 09:00 - 17:00\ +🏨 Grand Hall J\ ✍️ [pos.it/conf](http://pos.it/conf) ------------------------------------------------------------------------ @@ -27,16 +27,14 @@ This is a one-day, hands-on workshop for those who have embraced the tidyverse a ### Please note -These materials are under active development, which will likely continue through August 2023. -Given this context: if you have a concern, please [file an issue](https://github.com/posit-conf-2023/programming-r/issues). +These materials are under active development, which will likely continue through August 2023. Given this context: if you have a concern, please [file an issue](https://github.com/posit-conf-2023/programming-r/issues). ## Prework In short: -- Current versions of R & RStudio -- `library("devtools")` -- `library("tidyverse")` +- Current versions of R & RStudio +- `install.packages(c("devtools", "tidyverse", "palmerpenguins", "here"))` More details on our [pre-requisites page](pre-reqs.qmd). diff --git a/pre-reqs.qmd b/pre-reqs.qmd index 187363f..429a058 100644 --- a/pre-reqs.qmd +++ b/pre-reqs.qmd @@ -78,23 +78,10 @@ Download the relevant installer for your OS listed under "Installers for Support ## Install packages {#packages} -The aim of **`devtools`** [@devtools] is to make package development easier by providing R functions that simplify and expedite common tasks. The [R Packages](https://r-pkgs.org/) [@wickham2020a] book and the Building Tidy Tools workshop are based on a **`devtools`** workflow. +Most of the packages we use are imported by **`tidyverse`** and **`devtools`**: -Install **`devtools`**: - -```r -install.packages("devtools") -``` - -Install **`tidyverse`**: - -```r -# question - why not `install.packages()`? -devtools::install_github("tidyverse") -``` - -```r -install.packages(c("duckdb", "here")) +``` r +install.packages(c("devtools", "tidyverse", "palmerpenguins", "here")) ``` ## Git From cee3f8b87e8784537f1cba30bcab4c38a5d72bd6 Mon Sep 17 00:00:00 2001 From: Ian Lyttle Date: Mon, 28 Aug 2023 13:12:16 -0500 Subject: [PATCH 3/3] renormalize prereqs --- index.qmd | 8 +++ pre-reqs.qmd | 169 ++++----------------------------------------------- 2 files changed, 21 insertions(+), 156 deletions(-) diff --git a/index.qmd b/index.qmd index 7dc931f..93ffce1 100644 --- a/index.qmd +++ b/index.qmd @@ -35,6 +35,14 @@ In short: - Current versions of R & RStudio - `install.packages(c("devtools", "tidyverse", "palmerpenguins", "here"))` +- During the workshop we will have experienced helpers to troubleshoot and will use Discord to enhance workshop interactions: + + - [Please sign up for an account](https://discord.com/) if you don’t already have one. + - Make sure your [display name](https://support.discord.com/hc/en-us/articles/12620128861463-New-Usernames-Display-Names#h_01GXPQABMYGEHGPRJJXJMPHF5C) is the one you used to register for the conference. + - In your “About Me”, put the name of your workshop(s). + + Closer to the start of the conference, we will invite you to the posit::conf Discord server. + More details on our [pre-requisites page](pre-reqs.qmd). diff --git a/pre-reqs.qmd b/pre-reqs.qmd index 429a058..7a96ea5 100644 --- a/pre-reqs.qmd +++ b/pre-reqs.qmd @@ -8,178 +8,35 @@ execute: bibliography: references.bib --- -You will need +You will need: -- [R and RStudio](#install-r-and-rstudio) -- To [install some packages](#packages) +- [R and RStudio](#install-r-and-rstudio) +- To [install some packages](#packages) +- To connect to [Discord](#discord), for in-class interaction ## Install R and RStudio {#install-r-and-rstudio} -You will need: +We will use: - R version \>= 4.3 - RStudio \>= 2023.03.1 -### Installing R - -Download the pre-compiled binary for your OS from and install. - -#### For Windows - -Click "Download R for Windows", then "base", then "Download R #.#.# for Windows". This will download an `.exe` file; once downloaded, open to start the installation. If you do not have administrator rights, the installer will default to install in your Documents folder - if you prefer, you can change the location to another folder that you have write access to. - -#### For Mac - -Click "Download R for (Mac) OS X", then "R-#.#.#.pkg" to download the installer. Run the installer to complete installation. - -#### For Linux - -Click "Download R for Linux". Instructions on installing are given for Debian, Redhat, Suse and Ubuntu distributions. Where there is a choice, install both `r-base` and `r-base-dev`. - -### Installing R Studio - -Downloads are available from (scroll to the end of the page to see the downloads). You want RStudio Desktop (Open Source License). - -#### For Windows with no admin rights - -Download the `.zip` source archive under "Zip/Tarballs". Extract the files to a folder where you have write access, e.g. `C:\Users\username\RStudio`. In this folder, open the `bin` directory and find the RStudio program: it is named `rstudio.exe`, but the file extension will typically be hidden, so look for `rstudio`. Right-click this executable to create a desktop shortcut. Double-click the executable or use the shortcut to open. - -#### For all other operating systems - -Download the relevant installer for your OS listed under "Installers for Supported Platforms". Run the installer to complete installation. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ## Install packages {#packages} -Most of the packages we use are imported by **`tidyverse`** and **`devtools`**: +Most of the packages we use are imported by **`tidyverse`** and **`devtools`**: ``` r install.packages(c("devtools", "tidyverse", "palmerpenguins", "here")) ``` -## Git - -### Windows - -Check if Git is installed by running `which git` in the **Terminal** - -If `which git` didn't find Git installed: +In case of any installation problems, you will also have access to a Posit Cloud hosted RStudio project. -- Download and install from -- Keep all the default settings - - If the installer hangs with the progress bar at 100%, close the installer with Task Manager (press Ctrl + Alt + Delete; select Task Manager; find Git for Windows installer and close). -- Open RStudio. In the menus go to Tools \> Global Options \> Git/SVN. -- Check RStudio has found git under "Git executable:" - - You may need to click Browse and find the git executable. +## Discord {#discord} - - It may be under C:\\Users\\username\\AppData\\Local\\Programs\\Git\\ - remember if file extensions are hidden it will show as git rather than git.exe. Restart RStudio before trying to use git. - -### Mac - -Check if Git is installed by running `which git` in the **Terminal** - -If asked to install the Xcode command line tools, say yes! - -If `which git` didn't find Git installed, and if you weren't prompted to install it, run the following in the **Terminal**: `xcode-select --install` - -#### Other options for installing Git on a Mac - -- Recommended if you don't want to use the Terminal: - - Download and install from - - - If you're developing version controlled packages, you should get to using the Terminal -- Recommended if you do lots of scientific computing and using software that needs to be installed and updated regularly: - - You might first need to install Homebrew if this is your first time using it, see [brew.sh](https://brew.sh/) for instructions - - - Use Homebrew: Run the following in the Terminal: `brew install git` - -## GitHub account - -Register a GitHub account at [github.com](https://github.com/). - -- Incorporate your actual name! -- Reuse your username from other contexts. -- Pick a username you will be comfortable revealing to your future boss. -- Shorter is better than longer. -- Be as unique as possible in as few characters as possible. -- Make it timeless. -- Avoid words laden with special meaning in programming. -- Use all lower case letters. - -Advice and more information from [Happy Git with R](https://happygitwithr.com/) [@bryan] - -## Check link between RStudio and GitHub {#check-link-between-rstudio-and-github} - -Configure your `user.name` and `user.email` for git in RStudio with: - -```{r} - -usethis::use_git_config( - user.name = "Jane Doe", # actual first and last name - user.email = "jane@example.com" # email associated with GitHub account - ) -``` - -Communicating with GitHub will require authentication. Instead of typing in your username and password each time, use a PAT (personal access token) - -Create a PAT with: - -```{r} -usethis::create_github_token() -``` - -- Give the token a descriptive name -- Copy and also store this token somewhere (you won't be able to see it again!) - -Now put your PAT into the Git credential store with: - -```{r} -gitcreds::gitcreds_set() -``` - -::: aside -You may need to install **`gitcreds`** [@gitcreds]. -::: - -You can check your set up by asking for a "situation report": - -```{r} -usethis::git_sitrep() -``` - -The output for this function shows information about the link between RStudio and GitHub, but not all of it is relevant now. It is essential to check whether your name and email are correct and the PAT is showing as "discovered": - -``` -Personal access token for 'https://github.com': '' -``` +During the workshop we will have experienced helpers to troubleshoot and will use Discord to enhance workshop interactions: -### Personal Access Token +- [Please sign up for an account](https://discord.com/) if you don’t already have one. +- Make sure your [display name](https://support.discord.com/hc/en-us/articles/12620128861463-New-Usernames-Display-Names#h_01GXPQABMYGEHGPRJJXJMPHF5C) is the one you used to register for the conference. +- In your “About Me”, put the name of your workshop(s). -The [Managing Git(Hub) Credentials](https://usethis.r-lib.org/articles/articles/git-credentials.html) vignette in the **`usethis`** [@usethis] package has all the details on PATs! +Closer to the start of the conference, we will invite you to the posit::conf Discord server. Once you’ve accepted the invitation, we will add you to the channel(s) for your conference workshop(s).