Last Update: 22.02.2020

Git and github introduction

This repository gives a short introduction for Fontys University of Applied Sciences in Venlo Software Engineering and Business Informatics students regarding usage of Git and Github.

What is Git?

• DVCS – Distributed Version Control System
• Like a “more advanced” SVN (Subversion)
• Most used VCS in the world (>70%)
• Used often in open source projects

What is Github?

• Git hosting repository - see Github.com
• Besides hosting additional features
• Own workflow (pull requests)
• There are more hosters: bitbucket, gitlab ...

More information: github guide

Git basic commands

Command	Description	SVN command
git clone	Clones a repository – making a local copy	svn checkout
git status	To check the status of files you’ve changed in your working	svn status
git add	adds changes to stage/index in your working directory	svn add
git commit	commits your changes and sets it to new commit object for your remote	svn commit (differs in git)
git push/pull	Push or Pull your changes to remote. If you have added and committed your changes and you want to push them. Or if your remote has updated and you want those latest changes	svn commit (push is committing)
git branch	Lists out all the branches	svn copy
git checkout	Switch to different branches	svn switch (on branches) or svn revert (on files)
git stash	Save changes that you don’t want to commit immediately	does not exist in svn
git merge	Merge two branches you were working on	svn merge
git reset	You know when you commit changes that are not complete, this sets your index to the latest commit that you want to work on with.	svn revert (differs in git)

Markdown

Markdown is the language for documenting and communication. Comparable to Asciidoc.

How do write markdown:

Markdown Syntax

Headers

# This is an <h1> tag
## This is an <h2> tag
###### This is an <h6> tag

This is an <h1> tag

This is an <h2> tag

This is an <h6> tag

Emphasis (Bold, Italic)

*This text is italic*
_This is also italic_

This text is italic This is also italic

**This text is bold**
__This is also bold__

This text is bold This is also bold

_You **can** also combine them_

You can also combine them

Lists

Unordered

* Item 1
* Item 2
  * Item 2a
  * Item 2b

• Item 1
• Item 2
  • Item 2a
  • Item 2b

Ordered

You do not need to manually number your ordered list. Subsequent items in the list will be automatically numbered if you use - instead of numbers.

1. Item 1
- Item 2
- Item 3
   1. Item 3a
   - Item 3b

1. Item 1

• Item 2
• Item 3
  1. Item 3a
  • Item 3b

Combined

1. Item 1
- Item 2
   - Sub-item
   - Sub-item

1. Item 1

• Item 2
  • Sub-item
  • Sub-item

Task Lists

- [x] first, choose an ordered or unordered list style, then add checkboxes
- [x] completed item
- [ ] incomplete item

• first, choose an ordered or unordered list style, then add checkboxes
• completed item
• incomplete item

Tables

You can create tables by assembling a list of words and dividing them with hyphens - (for the first row), and then separating each column with a pipe |:

Column 1 Header | Column 2 Header
------------ | -------------
Content from cell 1 | Content from cell 2
Content in the first column | Content in the second column

First Header	Second Header
Content from cell 1	Content from cell 2
Content in the first column	Content in the second column

Strikethrough

~~strikethrough text like this~~

strikethrough text like this

Images

Image syntax allows for alternative text. The format is ![alt text](URL). The URL can be a relative project path or an external website URL.

![Org Logo](logo_square.png)
![Org Logo](https://raw.githubusercontent.com/wendikristine/documentation-template/master/logo_square.png)

Links

Links are created automatically in most cases (and always on Github). Or, you can specify a link with alternative text.

http://github.com - automatic!

[GitHub](http://github.com) link

GitHub link

Block Quotes

> "Not enough blinky lights."
> - Henry Neeman, SiPE 2018

"Not enough blinky lights."
~ Henry Neeman, SiPE 2018

Code

I think you should use an
`<addr>` element here instead.

I think you should use an
<addr> element here instead.

mkdir lesson06/   
cd lesson06   

Markdown supports language-specific syntax highlighting.

function fancyAlert(arg) {
  if(arg) {
    $.facebox({div:'#foo'})
  }
}

function fancyAlert(arg) {
  if(arg) {
    $.facebox({div:'#foo'})
  }
}

You can also simply indent your code by four spaces:

function fancyAlert(arg) {
  if(arg) {
    $.facebox({div:'#foo'})
  }
}

Horizontal Rule

---

---

Emoji

GitHub supports emoji! ✨ 🐫 💥

To see a list of every image we support, check out the Emoji Cheat Sheet.

See Mastering Markdown for more information about Markdown.

Git tools

There are a bunch of (GUI) Tools out there for interacting with Git. Ask Google to find out what your preference is.

In the first weeks the Github.com interface here is enough.

• Git CLI (Console in Linux, Windows, Mac)
• Github Desktop
• GitKraken
• Atlassian SourceTree
• Tortoisegit (Windows only)

Git and Github learning labs

To get even more familiar with Git and Github, visit the github learning labs.

• Recommended courses to take: https://lab.github.com/githubtraining/paths/first-day-on-github
• Optional courses: https://lab.github.com/githubtraining/paths/first-week-on-github