git

git is a version control software. With it, you can download repositories, track your changes and develop code collaboratively.

install git

This needs to be done only once :)

  • If not already done before: create a github account at https://github.com/signup. Use a short username!

  • Download and install git, see https://git-scm.com/downloads

  • Restart RStudio (if open)

  • Manage authentification without renewing PAT access tokes via SSH (screenshots for these instructions, if wanted):

    • RStudio -> Tools -> Global Options -> Git/SVN: Ensure the path to the Git executable is correct.
    • Create SSH Key, close window
    • View public key: copy the displayed public key
    • go to https://github.com/settings/keys and click New SSH key, name it and paste the public key
    • in the RStudio bottom/left Tab Terminal: type the following (line by line):
    git version # just to see git works fine
    git config --global user.email "Your_Email_Used_For_Github@domain.com"
    git config --global user.name "Your_Github_UserName_Here"

use git

To clone a git repo, RStudio handles most the work for you :)

    1. At RStudio - File - New Project - Version Control - Git,
      paste the repository URL, set the subdirectory and create project.
      I recommend to keep the Project directory name so local and github folder names match exactly.

    1. From now on, get the latest version with a single click on Pull:

git resources

Happy Git with R: https://happygitwithr.com
Excellent tutorial on git in general (mostly without RStudio): http://kbroman.org/github_tutorial
HPI course: https://open.hpi.de/courses/git2020
Contribute to OS software: https://egghead.io/courses/how-to-contribute-to-an-open-source-project-on-github