0% found this document useful (0 votes)
15 views

01B Getting Started With Github

Uploaded by

Priyanshi Shah
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
15 views

01B Getting Started With Github

Uploaded by

Priyanshi Shah
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 4

Setting up your Github account online

and on your local machine:

Part 1 of the following is the official GitHub instructions for setting up a github account,
adapted from https://docs.github.com/en/get-started/onboarding/getting-started-with-your-
github-account. My notes for you are highlighted in yellow

Part 1: Configuring your GitHub account


Your personal account is your identity on GitHub.com and represents you as an individual.

1. Creating an account
If you already have a GitHub account, skip to part 1 step 4. If you are creating a new GitHub
username, I suggest making it similar to your name (ex: mine is laurasisk).
To sign up for an account on GitHub.com, navigate to https://github.com/ and follow the
prompts to sign up for github.
To keep your GitHub account secure you should use a strong and unique password. For more
information, see "Creating a strong password."

2. Choosing your GitHub product


You can choose GitHub Free or GitHub Pro to get access to different features for your personal
account. You can upgrade at any time if you are unsure at first which product you want.
Choose the GitHub Free account

3. Verifying your email address


To ensure you can use all the features in your GitHub plan, verify your email address after
signing up for a new account. For more information, see "Verifying your email address."

4. Configuring two-factor authentication


Two-factor authentication, or 2FA, is an extra layer of security used when logging into websites
or apps. We strongly urge you to configure 2FA for the safety of your account. For more
information, see "About two-factor authentication."
Part 2: Complete the “Hello World” exercise
https://docs.github.com/en/get-started/quickstart/hello-world

Make the repository public so that I can see it on yor GitHub account. By the end of this
exercise, you should be able to describe what a repository, branch, commit, and pull request is.

Part 3: Experiment with Markdown

1. In your hello-world repository that you made in part 3, make a new branch called
markdown-test (Don’t remember how to get there? Check the hello-world tutorial).

2. Edit the readme file using info from the markdown cheatsheet to have:
a. A heading (any size) that says “Hello World”
b. bold text below the heading that says “this is a test for BIOL 668”
c. A blockquote telling me what your favorite animal is

3. Commit these changes to the markdown-test branch

4. Open and merge a new pull request to pull the changes you made to the main branch
Your new readme file should look something like this: https://github.com/laurasisk/hello-world

5. Look at the readme file for this program https://github.com/bioinformatics-centre/kaiju


to see how Markdown can be used to write a ReadMe file that is user-friendly. Which
Markdown elements from the markdown cheatsheet do you notice?

Part 4: Follow
1. Navigate to my GitHub profile and follow me so that I can find your profile for future
grading: https://github.com/laurasisk
2. Enter the link to your GitHub profile into the assignment on canvas (under the GitHub
module for the lab canvas)
Part 5: Setting up git for the command line
Windows users! For this section, you will need to either install a windows subsystem for linux
(WSL) or a linux virtual machine (VM) first, and then complete the command line portions of
this section on your WSL or VM. See instructions on the lab’s canvas under the “Intro” module.
1. Install git for the commandline on your machine:
https://git-scm.com/book/en/v2/Getting-Started-Installing-Git
If you’re a MAC user, follow the instructions for installing on macOS by running these
commands on the terminal command line. If you are a windows user, follow the instructions for
installing on linux; you must either be using a WSL or VM for this.

2. Set up git:
Set Your Identity
The first thing you should do when you install Git is to set your GitHub user name and email
address. This is important because every Git commit (save) uses this information, and it’s
immutably baked into the commits you start creating:

$ git config --global user.name "John Doe"

$ git config --global user.email [email protected]


The username and email you use here are for the GitHub account you set up in Part 1. Again,
you need to do this only once if you pass the --global option, because then Git will always use
that information for anything you do on that system. If you want to override this with a
different name or email address for specific projects, you can run the command without the --
global option when you’re in that project.

https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup
From this site, read about git config and look at your configuration settings using the following
command:

git config --list --show-origin

Based on the output of this command, what is your default editor?


NEED HELP???
These directions and more help are available at: https://docs.github.com/en/get-started

The Git reference manual is really well written and helpful! Bookmark/save this for use later in
the course: https://git-scm.com/book/en/v2/Getting-Started-About-Version-Control

Why GitHub? https://docs.github.com/en/get-started/using-git/about-git


What is Git? https://git-scm.com/book/en/v2/Getting-Started-What-is-Git%3F

You might also like