Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Cleanup of meta-material #33

Merged
merged 3 commits into from
Aug 28, 2023
Merged

Cleanup of meta-material #33

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
70e922e
reformat config, add titles
ijlyttle Aug 27, 2023
6f4cca6
update pre-reqs
ijlyttle Aug 27, 2023
cee3f8b
renormalize prereqs
ijlyttle Aug 28, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 5 additions & 6 deletions _quarto.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,6 @@ execute:
echo: true
warning: false



website:
title: "From R User to R Programmer"
navbar:
Expand All @@ -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

Expand Down
20 changes: 13 additions & 7 deletions index.qmd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)

------------------------------------------------------------------------
Expand All @@ -27,16 +27,22 @@ 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"))`
- 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).

Expand Down
186 changes: 15 additions & 171 deletions pre-reqs.qmd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,191 +8,35 @@ execute:
bibliography: references.bib
---

You will need
You will need:

- [R and RStudio](#install-r-and-rstudio) <!-- - [R package development toolchain](#install-r-package-development-toolchain): Rtools(windows) or XCode (mac) or r-base-dev -->
- To [install some packages](#packages) <!-- - [Git] --> <!-- - [GitHub account] --> <!-- - [GitHub to be linked to RStudio](#check-link-between-rstudio-and-github) -->
- [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 <https://cloud.r-project.org/> 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 <https://www.rstudio.com/products/rstudio/download/> (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 R package development toolchain {#install-r-package-development-toolchain} -->

<!-- #### For Windows with no admin rights -->

<!-- Download the latest (recommended) Rtools installer, `Rtools.exe`, from <https://cran.r-project.org/bin/windows/Rtools/>. Run the installer keeping the default settings. -->

<!-- #### For Windows with admin rights -->

<!-- Download the latest (recommended) Rtools installer, `Rtools.exe`, from <https://cran.r-project.org/bin/windows/Rtools/>. Run the installer making the following selections: keep the default settings for the installation location and components to install; check the box to add rtools to the system PATH. -->

<!-- #### For Mac -->

<!-- Install XCode. Either: -->

<!-- 1. Download and install XCode from the Mac AppStore: <http://itunes.apple.com/us/app/xcode/id497799835?mt=12> -->

<!-- 2. Within XCode go to Preferences : Downloads and install the Command Line Tools -->

<!-- Or for a smaller download size: -->

<!-- 1. Register as an Apple Developer (free) here: <https://developer.apple.com/programs/register/> -->

<!-- 2. Download the Command Line Tools for XCode appropriate for the version of OS X you are running from here: <https://developer.apple.com/downloads/> -->

<!-- #### For Linux -->

<!-- If you installed `r-base-dev`, when installing R, you should have all you need to build packages from source. Otherwise return to the instructions for installing R for your distribution and follow the instructions there to install the additional tools. -->

## 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.

Install **`devtools`**:

```r
install.packages("devtools")
```

Install **`tidyverse`**:

```r
# question - why not `install.packages()`?
devtools::install_github("tidyverse")
```
Most of the packages we use are imported by **`tidyverse`** and **`devtools`**:

```r
install.packages(c("duckdb", "here"))
``` r
install.packages(c("devtools", "tidyverse", "palmerpenguins", "here"))
```

## Git
In case of any installation problems, you will also have access to a Posit Cloud hosted RStudio project.

### Windows
## Discord {#discord}

Check if Git is installed by running `which git` in the **Terminal**

If `which git` didn't find Git installed:

- Download and install from <https://git-scm.com/downloads>
- 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.

- 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 <https://git-scm.com/downloads>

- 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 = "[email protected]" # 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': '<discovered>'
```
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).