How to use github

This is a short description about how we use GitHub for the Nether project. We have agreed upon the following:

• The master branch is in github.com/MicrosoftDX/nether
• We you start developing for nether you fork from the master branch to your own GitHub environment
• For each feature/bug you are working on you create a branch of your fork
• When you done with your work you create a pull request for the master branch
• Someone else from the team needs to validate the pull request

Preferably use powershell with posh-git to execute the git commands

Useful GitHub commands:

• git branch [name of your branch] - this will create a branch for you to work with
• git checkout [name] - this will change your branch to the given branch name
• git status - use this command as often as you can, it provides you with great insight
• git add . - this will add all you changes to your local list of changes
• git commit -m "Added feature [1]" - this will commit all your changes with some comments
• git push - this will push all your changes to your github.com repository
• git remote -v - this will show your repository connections, eg. from the master to your fork repository
• git remote add upstream https://github.com/MicrosoftDX/nether.git - this adds a upstream link between the repositories
• git branch -d [name of branch] - deletes the branch
• git pull [name of connection] [master repository]