How to Create a Pull Request on Github

Before making a pull request on Github, you will need to create your own branch off the master branch and make sure it is up to date. After that you are free to make and commit changes without affecting the main branch. Once a commit is...

Part 1 of 3:

Creating a New Branch

  1. Picture 1 of How to Create a Pull Request on Github
    Open Git. If you do not already have a Git program, go to https://git-scm.com/downloads and choose and installer for the platform you are using.
    1. If you are setting up git for the first time you also need to clone or import/create a repository before contributing to it.
  2. Picture 2 of How to Create a Pull Request on Github
    Navigate to your projects directory. Enter 'cd ' in the command line and hit Enter, where is the directory chain that leads to where you cloned or created your project folder.
    1. You can drag and drop the folder into the Git command window to automatically fill out the directory path.
  3. Picture 3 of How to Create a Pull Request on Github
    Make sure your repository is up to date. Enter 'git pull origin master' into the command line and hit Enter. A message will appear letting you know that repository is up to date.
    1. Master is the default branch on a project.
  4. Picture 4 of How to Create a Pull Request on Github
    Navigate to the github repository page. Open your web browser and enter your repository's unique github URL.
  5. Picture 5 of How to Create a Pull Request on Github
    Click the 'branch:master' dropdown'. This is located in the upper left of the page and will open a list of other branches and a text box.
  6. Picture 6 of How to Create a Pull Request on Github
    Enter a branch name and click 'Create branch' when it appears. This will create a new branch off the master branch using whatever name you entered into the text box.
    1. You can also create a branch from the command line. Enter 'git checkout branch -b ' and hit Enter, where is whatever you want your branch to be called.[1]
    2. You can now use 'git commit' and 'git push' to safely make changes to your branch without affecting the main project. Making a pull request will allow others to review and discuss your changes before merging them back into the main branch.[2]
  7. Picture 7 of How to Create a Pull Request on Github
    Commit changes to your new branch. Click the Pencil icon to edit a file on the repository. Once edits are made, enter a commit message and click 'Commit' from the window below the editing area.
    1. You can also make commits from the command line. This is useful when making changes to files locally rather than on the git website. Enter 'git commit -m ' into the command line and hit Enter after making changes to a file. should be a brief description of the changes you made.
    2. Commit message text can be anything, but something here is required.
Part 2 of 3:

Making a Pull Request

  1. Picture 8 of How to Create a Pull Request on Github
    Click the 'Pull Requests' tab. This is located along the top menu bar on your repository page.
    1. A Pull Request is a Git feature used to present changes made on independent branches for review by collaborators before being merged into the main project.
  2. Picture 9 of How to Create a Pull Request on Github
    Select the branch you created from the list. This will display the changes you made compared with the original content on the master branch.
  3. Picture 10 of How to Create a Pull Request on Github
    Click 'Create Pull Request'. Once you are satisfied with the state of your changes, this is the green button in the upper left, by the branch dropdown.
  4. Picture 11 of How to Create a Pull Request on Github
    Enter a name/description for your pull request. Use these fields to help identify and briefly describe the change you are making to other collaborators.
  5. Picture 12 of How to Create a Pull Request on Github
    Click 'Create Pull Request'. This will create the pull request with the entered name and description.
Part 3 of 3:

Merging a Pull Request

  1. Picture 13 of How to Create a Pull Request on Github
    Click 'Merge Pull Request'. This button appears in the lower right once the pull request has been successfully created.
    1. You can also use 'git merge ' in the command line to perform the same action.
  2. Picture 14 of How to Create a Pull Request on Github
    Click 'Confirm merge'. A notification will appear informing you that the pull request was successfully merged back into the master branch. Since your branch is no longer necessary, you will be prompted to delete it.[3]
    1. If you have any merge conflicts, you will be notified and unable to proceed with the merge. You will need to go back and re-pull from the master branch to make your own branch up to date with any changes, then create a new pull request.
  3. Picture 15 of How to Create a Pull Request on Github
    Click 'Delete Branch'. This will appear in the notification next to the purple branch icon. Deleting merged and outdated branches is a good way to keep a project organized and easy to manage.
Update 05 March 2020
Category

System

Mac OS X

Hardware

Game

Tech info

Technology

Science

Life

Application

Electric

Program

Mobile