Pull requests and code review
Propose changes on a branch, get them reviewed, and merge through a pull request.
1. Open pull requests
Click the Pull requests tab on a repository to open
/{owner}/{repo}/pulls, or click New pull request to start one directly.2. Choose branches
On
/{owner}/{repo}/pulls/new, pick the Merge into (target) branch and the From (source) branch, add a Title and optional Description (markdown supported,@mentionsnotify teammates), then click Create pull request.3. Request review
On the pull request page, enter one or more usernames (comma-separated) under Reviewers and click Request review. Reviewers get a notification and can respond with Approve, Request changes, or Comment only.
4. Discuss changes
Use the Conversation tab to read the description and comment thread, and the Files changed tab to review the diff between the source branch and the target branch's merge base.
5. Merge or close
A maintainer clicks Merge pull request to merge (creating a merge commit on the target branch), or Close pull request to close it without merging. If the target branch has Require review to merge enabled (see Protected branches), the merge button stays disabled with an explanation until at least one approval exists with no outstanding change requests.