Skip to content

pull-request-reviews.md

Latest commit

 

History

History
54 lines (41 loc) · 3.53 KB

pull-request-reviews.md

File metadata and controls

54 lines (41 loc) · 3.53 KB
Raw
title Pull request reviews
intro Review pull requests to provide feedback, suggest changes, and ensure code quality before merging.
redirect_from
/pull-requests/concepts/about-pull-request-reviews
/github/collaborating-with-issues-and-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews
/articles/about-pull-request-reviews
/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews
/github/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews
/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/about-pull-request-reviews
versions
fpt ghes ghec
*
*
*
shortTitle PR reviews
category
Review pull requests
contentType reference

Pull request reviews let people comment on changes, suggest improvements, and approve or request changes before code is merged. Anyone with read access can review and comment on proposed changes, helping teams maintain code quality and share knowledge.

{% raw %}View pull requests awaiting your review{% endraw %}

Review decision types

When a reviewer submits a review, they choose one of the following decisions:

Decision Meaning
Comment Leaves general feedback without explicitly approving or requesting changes.
Approve Signals that the changes are ready to merge.
Request changes Flags feedback that the author should address before merging.

Reviewers can also comment on specific lines, suggest exact changes, and discuss implementation details. Review conversations appear in the pull request timeline so the team can track feedback and decisions.

Requesting and requiring reviews

Reviews can be requested from specific people or teams when they need feedback from the right experts.

To request a review, you need write access to the repository. You can request a review from a person or team with read access to the repository, and they receive a notification.

  • Pull request authors can request reviews only if they are repository owners or collaborators with write access.
  • Organization members with write access or triage permissions can also assign a reviewer for a pull request.
  • If you request a review from a team and code review assignment is enabled, specific members will be requested and the team will be removed as a reviewer.

If you define code owners in a CODEOWNERS file, {% data variables.product.github %} can automatically request review from owners when a pull request changes their code. See AUTOTITLE.

Repository administrators can require approvals before pull requests are merged. Required reviews help protect important branches and reduce accidental merges. See AUTOTITLE.

Further reading