index.Rmd

--- 
title: "Happy Git and GitHub for the useR"
author: "Jenny Bryan and the STAT 545 TAs"
date: "`r Sys.Date()`"
site: bookdown::bookdown_site
output: bookdown::gitbook
documentclass: book
bibliography: [book.bib, packages.bib]
biblio-style: apalike
link-citations: yes
github-repo: jennybc/happy-git-with-r
description: "Using Git and GitHub with R, Rstudio, and R Markdown"
twitter-handle: jennybryan
---

# A work in progress {-}

<img src="img/watch-me-diff-watch-me-rebase-smaller.png" width="669" height="400" alt="Cover image" />  

Still from [Heaven King video](https://www.youtube.com/watch?v=uBWrpVrazzA)

What is already here:

  * Instructions for Git/GitHub/R/RStudio set-up and early usage.
  * Prompts for workshop activites.

What is coming:

  * More on Git itself, though will mostly rely on rest of the internet for that. I want to add / borrow / link to visual explanations.
  * Workflows and policies for individuals and groups.
    - How often should I commit? Which files should I commit?
    - Data files and the dilemmas they present.
    - Most common Git predicaments. How to avoid and recover.
    - Clone vs fork.
    - Purpose of branches, [issues](https://guides.github.com/features/issues/), [pull requests](https://help.github.com/articles/using-pull-requests/), tags.
    - Add-as-collaborator vs "fork and pull".
  * Use of the GitHub API for bulk operations.
  * Using GitHub to run a course.
    - Get an Organization.
    - Use of Teams, repos, issues, pushing content into repos.

Repo that makes this site: <https://github.com/jennybc/happy-git-with-r>

Slides I draw on in live workshops: <https://speakerdeck.com/jennybc/happy-git-and-github-for-the-user>

<a rel="license" href="http://creativecommons.org/licenses/by-nc/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-nc/4.0/88x31.png" /></a><br /><span xmlns:dct="http://purl.org/dc/terms/" property="dct:title">Happy Git and GitHub for the useR</span> by <a xmlns:cc="http://creativecommons.org/ns#" href="https://github.com/jennybc/happy-git-with-r" property="cc:attributionName" rel="cc:attributionURL">Jennifer Bryan</a> is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-nc/4.0/">Creative Commons Attribution-NonCommercial 4.0 International License</a>.

```{r include=FALSE}
# automatically create a bib database for R packages
knitr::write_bib(c(
  .packages(), 'bookdown', 'knitr', 'rmarkdown'
), 'packages.bib')
```