Section 6 GitHub (part one)

In this part of the book we will introduce GitHub, which is one of several places you can host - store and display your project files. GitHub can only work with git tool, hence the name. However there are other vendors that are a more tools agnostic

6.1 Introduction

GitHub has been around for more than 10 years. The original, and the most dominant still, purpose is store software source code in public. By putting your code on display gave at least two important benefits:

  1. “free” and easy code oversight: sanity and bugs checks
  2. ease of collaboration: take a copy and play with it, PR (pull request) later

GitHub platform has become indispensable to the software industry.

There is some lingo that is associated with GitHub, the most central one is “repository” or “repo” for short. That simply refer to a folder (a.k.a directory) on your computer that had git initiated as per Git init section. Your GitHub account can have any any number of repos, each one of them is a distinct project.

6.2 New repository

Prerequisite: Have to register for a GitHub account first at

Let’s begin by making a new repository. Go to and look for plus sign (New repository). Interface may change time to time, but look at the top right hand corner. Once you’ve clicked on “New repository” button, you should see the following window 6.1

New repository dialog at

Figure 6.1: New repository dialog at

Let’s give our new repository a name and a short description. Type the following text and press green button on the bottom of the screen “Create repository”

I'm learning Rmarkdown, Git and GitHub


  • Don’t select any other options, keep repository public
  • It is a good practice NOT to use spaces in your repository name. Here we are using an underscore instead.
New repository dialog at, with text

Figure 6.2: New repository dialog at, with text

6.3 Repository address (git remote`)

Once you’ve clicked on “New repository” button you should see the following, new window appearing in front of your 6.3 (provided you didn’t select any of the additional files, like README file)

Copy on your clipboard URL that is presented to you at the top of the page. For me the url looks the following

It will look very similar in your case, except the username part. The following if your typical URL structure for github repositories. Note that square brackets is a convention meaning “substituted with”, they don’t need to be included in your actual URL[USERNAME]/[REPOSITORY_NAME]
Secondary window, once new repository was created at

Figure 6.3: Secondary window, once new repository was created at