github-primer.md

Introduction to GitHub

NOTE: If you haven't completed the GitHub Survey yet, please do so before Monday, July 31st.

Getting Started

Installing git

In order to use github (or any other git provider) for source control and contribution, you need git installed locally.

If you are comfortable working in the command line:

• Mac Setup
• Windows Setup
• Linux Setup

If you would prefer a GUI:

• GitKraken - Available for Windows, Mac, and Linux
• SourceTree - Available for Windows and Mac

Repositories

Remote @ Github

1. Login to Github
2. From the homepage, click the Start a Project Button
3. Put "test" in the repository name field (you should see a green check mark)
4. Notice the public/private selection
5. Make sure the checkbox for "Initialize this repository with a README"
6. Leave "Add .gitignore" and "Add a License" both with None.
7. Click "Create repository"

Local

No we're going to clone the repository we created above into a local repository.

1. Clone the repo wherever you like
2. Check the status of the repository

Forking, Branching, and Contributing

What the fork?

1. Fork this repository: https://github.com/aaron-collier/libit17

Branching

1. Clone the repository locally as we did before
2. Create a new local Branch
3. Make a change
4. Push changes to your version of the repository

Contributing through Pull Requests (PRs)

1. Create a PR from your local version to the original master.

Tools

• GitKraken - Available for Windows, Mac, and Linux
• SourceTree - Available for Windows and Mac

Resources

Markdown Cheat Sheet