README.md

Hands-On (Hacky Hour @ DPG spring meeting 2019, Rostock)

Installation

Online only

You can either complete this tutorial online using only GitHub, in which case you need a to have a (free) account.

• Create an account here

Alternative

Or you can use a local repository (with or without a linked GitHub account). In this case you need a local installation, instructions are as follows:

• (Recommended for Windows/MacOS) For git + a slim and essential GUI: GitHub Desktop.
• (Other OS/Else) See instructions here

Let's do this

Depending whether you use GitHub only online or a local installation, go to different websites:

• If you are using GitHub online, follow this Git Hello World! example.
• If you are using git locally, follow steps 1. to 5. of this guide.

  Note for users of GitHub Desktop:
  No dedicated examples for you today, but you can follow the link above in the GUI as well.
  The command names given are identical to the buttons you are looking for in the GUI.
  I have faith in you, you will figure it out! :)

A basic workflow

Source: Tom Blount - A basic git workflow

Overview of common commands / actions

git status
git add
git commit -m "(Message)"
git push
git pull
git branch
git checkout
git log
git diff
git merge

Online ressources

(You should) look at this

• Introductionary presentation: Think git
• Good commit messages

(You might want to) learn more here

• A minimalistic git guide
• In-depth git best practices
• Git it - an interactive tutorial
• Git Reference
• eBook: Pro Git
• Collection of ressources for learning Git

(If you are curious) Here are some more appetiseres

• Various examples of GitHub in academia
• TechBlog: Git: The reproducibility tool scientists love to hate
• List of version-control software