Skip to content

Latest commit

 

History

History
47 lines (33 loc) · 3.54 KB

keeping-your-pull-request-in-sync-with-the-base-branch.md

File metadata and controls

47 lines (33 loc) · 3.54 KB
title intro permissions versions topics shortTitle
Keeping your pull request in sync with the base branch
After you open a pull request, you can update the head branch, which contains your changes, with any changes that have been made in the base branch.
People with write permissions to the repository to which the head branch of the pull request belongs can update the head branch with changes that have been made in the base branch.
fpt ghes ghec
*
*
*
Pull requests
Update the head branch

About keeping your pull request in sync

Before merging your pull requests, other changes may get merged into the base branch causing your pull request's head branch to be out of sync. Updating your pull request with the latest changes from the base branch can help catch problems prior to merging.

You can update a pull request's head branch from the command line or the pull request page. The Update branch button is displayed when all of these are true:

  • There are no merge conflicts between the pull request branch and the base branch.
  • The pull request branch is not up to date with the base branch.
  • The base branch requires branches to be up to date before merging or the setting to always suggest updating branches is enabled.

For more information, see "AUTOTITLE" and "AUTOTITLE."

If there are changes to the base branch that cause merge conflicts in your pull request branch, you will not be able to update the branch until all conflicts are resolved. For more information, see "AUTOTITLE."

From the pull request page you can update your pull request's branch using a traditional merge or by rebasing. A traditional merge results in a merge commit that merges the base branch into the head branch of the pull request. Rebasing applies the changes from your branch onto the latest version of the base branch. The result is a branch with a linear history, since no merge commit is created.

Updating your pull request branch

{% data reusables.repositories.sidebar-pr %}

  1. In the "Pull requests" list, click the pull request you'd like to update.
  2. In the merge section near the bottom of the page, you can:
    • Click Update branch to perform a traditional merge.

      Screenshot of the merge section for a pull request.

    • Click the update branch drop down menu, click Update with rebase, and then click Rebase branch to update by rebasing on the base branch.

      Screenshot of the merge section for a pull request. The dropdown menu is expanded, showing "Update with merge commit" and "Update with rebase" options.

Further reading