GitHub Tour

We will be working with Git and GitHub as our version control system.

Go to the GitHub Desktop website: https://desktop.github.com/
Click the purple button that says “Download for…”
- A zipped file will eventually appear in your Downloads folder. Open up your Downloads folder.
After unzipping the folder, you should see the purple GitHub Desktop icon. I suggest dragging this to your Dock.

Check the “Do not show this message again”, and choose the white “Not now” button.

Once GitHub Desktop is open, we should login with your new account
- Mac users: Next to the Apple icon, click GitHub Desktop -> Preferences -> Accounts -> Sign-in

Windows users: Next to the app icon, click File -> Options -> Accounts -> Sign-in

You will be direct to the github.com broswer to sign-in. Enter your corresponding GitHub account information.
Once authenticated, your GitHub Desktop client should be set up!

Go to the course organization on GitHub and find the repo with the prefix appex-02-.
Click on the green Code button, select the second option “Open with GitHub Desktop”

The GitHub Desktop application will open up, with a white window that says “Clone a Repository”. Important: in the second line that says “Local Path”, there is a button that says Choose.... Click on it, and find and select the folder we created for this course. Then hit the blue Clone button.

After successfully cloning, the window will disappear and you will see the that Current Repository is the one you just cloned.
Success!

Open the RMarkdown file appex02-starwars.Rmd in RStudio. We will use that for the next part of class.
The R package that we will rely on most heavily is the tidyverse package. Please install it now by typing the following in your Console:
Put your name for the author, then knit the document. It’s important to knit the document, as this saves your progress!
Open GitHub Desktop. On the left, you should see the names of files you changed or created. That’s good! That means that your version locally is different than the previous version.
On the left hand side next to your photo/graphic, type a brief comment such as “Update author name”. Push the blue Commit to main button. After that, the third tab at the top that says Push origin should have an upward arrow with a number next to it. That means you are ready to send your changes to GitHub. Click Push origin, and you should see that it successfully completes the action.

Note: sometimes, the push doesn’t execute properly and the application “hangs” (i.e. doesn’t complete and says it is still in progress). In this event, quit out of GitHub Desktop. Then re-open it. Your commit message should still be there. Try pushing again.
If you refresh your repo on GitHub, you will see the updated files with your commit message.

On the corresponding repository in GitHub, find the README.md file at the bottom. Edit this file by clicking on the pencil and typing your name + major + year.
Once you’re finished editing, hit the green “Commit changes” button.
Back in GitHub Desktop, find the Fetch origin tab. Since your local version is not up to date, you should pull the changes by hitting the button.
Find and open the README.md file in the Files pane of RStudio. You should see your changes here locally!