R Projects and Github

class: center, middle, inverse, title-slide

# R Projects and Github
## Hannah L. Owens
### <span class="citation">@HannahOish</span>
### 2021-09-06

---

# Reflexive project management

---

# Reflective project management

---

# Part 1: Git and GitHub

---
# What is Git?

.pull-left[
* A method of version control
* Records of changes
    + What
    + When
    + *Why*
]

.pull-right[
<img src="https://properdiscordblog.files.wordpress.com/2012/09/screen-shot-2012-09-12-at-08-38-56.png" width=400>
]

---

# What is GitHub?

.pull-left[
* A cloud-based repository
* A collaboration tool
  + Code sharing
  + Networking
  + Documentation
  + Bug reporting
* [GitHub Tour](https://github.com/hannahlowens)
]

.pull-right[
<img src="https://media.wired.com/photos/5b888623cde746582fe9ff7f/master/w_2500,h_1667,c_limit/20130925-GITHUB-NEW-OFFICE-008edit.jpg" width=400>
]

---

# Comparison of Git and Github

---

# Ok, I'm sold. Now what?

Step 1: Install git.  
  + [GitHub's Guide to Git](https://github.com/git-guides/install-git)

---

# Ok, I'm sold. Now what?

Step 1: Install git.  
Step 2: Sign up for GitHub.  
  + [Link to GitHub main page](https://github.com/)

---

# Ok, I'm sold. Now what?

Step 1: Install git.  
Step 2: Sign up for GitHub.  
Step 3: Set up a repository.  
  + [Link to GitHub repository setup](https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/creating-a-new-repository)

---

# Part 2: R Projects

---

# What is an R Project?

.pull-left[
* A method of organization
* Associated with a project directory
  + Keeps everything together in one place
* A file type
  + `.Rproj`
]

.pull-right[
<img src="https://static.wikia.nocookie.net/lotr/images/8/8b/DOiAi2WUEAE3A1Y.0.jpg" width=400>
]

---

# Starting a new R Project

.pull-left[
* From existing GitHub repository
  + Live demo!
  + [Happy Git with R article](https://happygitwithr.com/rstudio-git-github.html)
]

.pull-right[
<img src="http://www.rstudio.com/images/docs/projects_new.png" width=400>
]

---

# Starting a new R Project

.pull-left[
* From existing GitHub repository
  + Live demo!
  + [Happy Git with R article](https://happygitwithr.com/rstudio-git-github.html)
* From scratch
  + This can be annoying
  + [But if you want to try doing it this way](https://intro2r.com/setting-up-a-project-in-rstudio.html#opt2)
]

.pull-right[
<img src="http://www.rstudio.com/images/docs/projects_new.png" width=400>
]

---

# Basic Organization

.pull-left[
* Keep things simple
* Like this -->
]

.pull-right[
<img src="https://i1.wp.com/raw.githubusercontent.com/martinctc/blog/master/images/RPROJECT_2000dpi.png?w=578&ssl=1" width=400>
]

---

# Pushing and pulling your project

.pull-left[
* Think of it like hitting "Save".
* "Pull" downloads updates from GitHub
* "Commit" accrues local changes
* "Push" sends updates to GitHub
]

.pull-right[
<img src="https://i.ytimg.com/vi/0nqJKEh3YCc/maxresdefault.jpg" width=400>
]

---

# Two important files in any project

.pull-left[
* `.gitignore`
* `README.md`
* Live tour
]

.pull-right[
<img src="https://i.ytimg.com/vi/0nqJKEh3YCc/maxresdefault.jpg" width=400>
]

---

# More resources

* [R for Data Science Chapter on R Projects](https://r4ds.had.co.nz/workflow-projects.html)
* [R Studio article on R Projects](https://support.rstudio.com/hc/en-us/articles/200526207-Using-Projects)

---

.left-column[
# Fin.
]

.right-column[
<img src="https://octodex.github.com/images/original.png">
]