I am going to bore you with...

1. What is Open Source

2. What is GitHub

3. What is a Git Repository

4. What is Forking and Cloning

5. Setting up Git on your computer

6. git add, git commit, git push

7. git fetch, git merge, git branch

8. Git Workflow

9. Contribution guidelines

Why should I contribute?

• To add the functionality you want

• To get experience about any technology you have just learnt

• To work with people from around the globe

• To learn new things 

• To get a feeling of a significant work

• To get known by people in a community

• To showcase your skills by working on real-world projects

Getting Your Hands Dirty...

Git Structure

Remote Server(Github)

Local System (Your PC)

• Github Profile

• Online Repositories

• Work Graph

• Navigable code

• Git bash(terminal)

• Local copy of Git Repo

• Edit files locally

• Working branches

Setting up for first use

Open up your terminal and set up your user name, as

$ git config --global user.name "YOUR NAME"

Set up your e-mail address(the one you signed up with on github), as

$ git config --global user.email "YOUR EMAIL ADDRESS"

For Further Reference: https://help.github.com/articles/set-up-git

git clone

Clones a repo from Remote Server(Github Website) to your local machine(PC).

$ git clone "REPOSITORY CLONE ADDRESS"

For example, 

$ git clone https://github.com/smvdu/sfd-smvdu.git

Review

1. What is Open Source

2. What is Github

3. What is a Repository

4. Forking a Repo

5. Cloning a Repo

git status

"git status" shows the modified files in cloned copy of repo on the local machine.

$ cd "REPO NAME"
$ git status
    on branch master
    Files modified:
        file1
        file2
        .
        .

git commit

"git commit" will group together all the changes you have made with a meaningful message.

$ git commit -m "DESCRIPTION ABOUT MODIFICATIONS"

-m stands for commit message

Review

1. cloned a repo using git clone

2. made some modifications using a text editor

3. checked for modified code using git status

4. finalized files to be committed using git add

5. committed added files using git commit

6. README and .gitignore file

git push

"git push" sends all the commits to the remote server(Github), from where you cloned your repo.

$ git push "REMOTE NAME" "BRANCH NAME" 

$ git push origin master

eg:

git pull

"git pull" is similar to "git fetch", but it also runs "git merge" command by itself.

git pull will update all the branches in local repo. Whereas while using git fetch only listed branches will be updated.

$ git pull upstream 

merge-conflicts

• Arise while using "git merge" command

• When git can't decide by itself which code to be preserved

• merge conflicts has to be removed by the programmer manually

• There shouldn't be any merge conflicts before sending a Pull Request

<<<<<<<< HEAD
def func(a b):
=============
def func(x, y):
>>>>>>> refs/head/new_func

Review

1. Git branching structure
2. git push to push new changes on your forked repo
3. Pull Requests to submit your changes to parent repo
4. git fetch and git pull to update your local repo
5. git merge to merge two different copies of code
6. merge-conflicts and how to remove them

The Next LeveL

• git init
• git diff
• git log
• git rebase
• git reset
• git stash

Github Flow

https://guides.github.com/introduction/flow/index.html

Github Issues

• Used to define and assign tasks to be completed

• Used for any queries regarding the code

• Used to report a bug or to give a suggestion

Git Network Graph

Contribution Workflow

1. First of all fork the the repo and clone it to your local machine

2. Run the code on your local machine

3. Check out the issue page on Github for the repo

4. Pick up one of the issue and start working on it

5. Comment below on the issue if there is any doubt

6. Every good repo on Github has a contribution guidelines link, go through it

7. Start working on the issue

8. Create a different branch for every new task

9. For every small change, create a commit

10. push the code to your forked repo

11. From there send a Pull Request to the parent repo

A word about Commit messages

Keep them meaningful, short and to the point.

Create a Repo of your own and run all listed operations on it.

References/Resources

• https://help.github.com/articles/set-up-git
• https://help.github.com/
• https://try.github.io/levels/1/challenges/1
• http://www.codecademy.com/blog/74-getting-started-with-git
• https://help.github.com/articles/setting-guidelines-for-repository-contributors
• http://stackoverflow.com/questions/10240125/working-with-readme-md-on-github-com
• http://nvie.com/posts/a-successful-git-branching-model/
• https://training.github.com/kit/downloads/github-git-cheat-sheet.pdf

Create.Share.Collaborate

Thank you :)

SHOOT YOUR QUESTIONS...