forked from mdbeckman/USCOTS-2019-Breakout-Materials
-
Notifications
You must be signed in to change notification settings - Fork 1
/
uscotsGithubStatisticsCourse.Rpres
113 lines (74 loc) · 2.97 KB
/
uscotsGithubStatisticsCourse.Rpres
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
Integrating Git/Github into the course workflow
========================================================
author:
date:
autosize: true
<center>
Adam J Sullivan <br> Brown University
Matthew Beckman <br> Penn State University
U.S. Conference on Teaching Statistics <br> State College, PA <br> May 17, 2019
Session URL: https://uscots-2019.github.io
</center>
Tools for breakout session
========================================================
- Laptop (etc)
- Internet connected
- fine to share with partner
- GitHub
- www.github.com
- create UserID now if needed
- NOTE: userID can **NOT** be changed in future
- RStudio Cloud
- https://rstudio.cloud
- log in with your GitHub credentials
- GitHub Classroom
- https://classroom.github.com
- just open tab in web browswer
Goal: minimum viable implementation
========================================================
- first student exposure to Git/GitHub
- RStudio integration
- instructor configuration of GitHub Classroom
- GitHub organization
- Unlimited private repos for class
- deploy assignments to students
- assessment/evaluation of version control as a learning objective
Roadmap for breakout session
========================================================
- (discussion) What's Git/GitHub & why should we care?
- (hands-on) How to first introduce your students to GitHub
- (hands-on) Create GitHub organization for the class
- (hands-on) Link "new classroom" in GitHub Classroom
- (hands-on) Deploy assignments
- (discussion) assessment/evaluation of source control as a learning objective
- Wrap-up discussion
Why version control?
========================================================
- more at the end... (time permitting)
- Git is a version control tool
- plays nice with RStudio
- files organized in repositories (a.k.a. "Repo")
- there are other tools (e.g., Subversion/SVN, Mercurial)
- GitHub is a web-based repository hosting service
- remote storage of repositories
- includes additional features to make things user-friendly
- standard tools for professional statisticians/data scientists
- streamline collaboration
- capture entire history/evolution of a file (or project)
Hands-on exercises
========================================================
- How to first introduce your students to GitHub
- Create GitHub organization for the class
- Link "new classroom" in GitHub Classroom
- Deploy assignments
Workflow: RStudio with Git Integration
========================================================
1. Open the RStudio Project connected to your Git(Hub) Repo
2. Work on your computer
3. **SAVE** your work often
4. When you want to preserve a **snapshot** of your project, you make a **COMMIT**
5. Regularly **PUSH** commits them to the GitHub remote server
6. **PULL** clones the most up-to-date version of the files from the GitHub remote to your local computer
7. repeat steps 2 through 5
Evaluation
========================================================