In Class Activity
This in-class activity will get you set up for initial use of GitHub in RStudio.
Student Learning Objectives
At the end of this topic, you should be able to:
- Create a new repository on GitHub.
- Check out, modify, commit, and push changes in RStudio back to GitHub.
In Class Activities
Logistics & Registration
The following steps should get you to be configuring your github account properly.
- Go to https://github.com and register as a user. Your user name will be used publically, so choose one appropriately.
- Save your username and password in a secure location (password manager…).
- Configure a personal access token (Settings -> Developer Settings -> Personal Access Token). Make sure to select a long enough time frame (rest of the calendar year) that you do not have to go back and do this again too frequently.
- Save the personal access token with in a secure location (password manager…).
- Feel free to add a photo and other information for your account. You can link this from your LinkedIn account or other social media sources, it is a verifiable repository for artifacts of intellectual content.
In this section, we will use the web interface to create a new repository and then use RStudio to craft a new project from it, make changes, and then push it back to GitHub.
- Log into your GitHub account.
- Select “Repositories” from the menu and then create a New one with the following characteristics.
- No Template
- Pick a publically visible name for your first test repository and put it into the
Repository name
field. - Add a short description.
- Make it
Public
- Add a
README
file. - For
.gitignore
selectR
as the language. - Explore a license (add one or not, it is up to you).
- Create the repository.
Editing Online
The GitHub web interface allows you to edit content (add and delete as well) online. I recommend this to mostly quick items. To edit, select the file and then click on the ✏️ icon in the title pane for the file. Once you are done editing, you must commit
the changes you’ve made (and put in good description of what you did).
- Select the
README.md
file and edit it.
- Add a paragraph of text to the file.
- Commit the changes (give a commit message) and see how the content you added to the file changes the overall repository front page.