Module 1

Table of Contents

1.3 GitHub

GitHub is the single largest host for Git repositories, and is the central point of collaboration for millions of developers and projects. A large percentage of all Git repositories are hosted on GitHub, and many open-source projects use it for Git hosting, issue tracking, code review, and other things.

You can setup an account by visiting https://github.com

Contributing to a Project

Forking Projects

When you “fork” a project, GitHub will make a copy of the project that is entirely yours; it lives in your namespace, and you can push to it.

Creating a Pull Request

Vist https://github.com/dwit013/ and go to testrepo . Fork the project. The project should appear in your repository list.

Next clone the repository locally.

 
$ git clone https://github.com/dwit013/testrepo.git 
Cloning into 'testrepo'...
remote: Enumerating objects: 3, done.
remote: Counting objects: 100% (3/3), done.
remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (3/3), done.

Make some changes to the project. For example, add a new file. Then add the changes to the staging area and commit the changes.

$ git add myfile.txt
$ git commit -m "Added myfile.txt"
[master 60f8194] Added myfile.txt
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 myfile.txt

$ git push origin master
Counting objects: 3, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 281 bytes | 281.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0)
To https://github.com/awalesushil/testrepo.git
   40ad3ba..60f8194  master -> master

Now the your local changes should appear on your forked github repository.

  1. Next click on the New Pull Request button.
    2. The opened page will show the changes that you have made to the original repository.
  2. Click on the Create Pull Request button.
  3. Next add a comment and create a pull request.

Your pull request shall appear in the Pull Request tab of the original repository page. The owner of the repository can either accept or reject your pull request.

Further Reading

Git Book
How to use git efficiently

« Prev Next »