Review and approve pull requests

As an assigned reviewer of a pull request, you can add comments to the changes, identify issues, make suggestions, answer questions, and vote to approve a pull request. As an administrator, you can bypass the review process and instantly approve pull requests or send them for rework.

Approve a pull request

You assign reviewers to a pull request before you publish it. If you are the reviewer of a pull request, you can:

  • View the associated code changes.
  • Add review comments and collaborate with team members.
  • View the results of chains that have run on the pull request.
  • Vote to approve changes to the pull request.

To review and approve a pull request:

  1. On the top navigation bar, select a space from the spaces list.

  2. (Optional) To restrict the scope of the search, open a product or Git repository and then a stream/branch.

  3. On the sidebar, select Reviews.

  4. Open a pull request from the review list.

  5. To view code changes, click the Changes tab. The Changes page displays all the files in the review. To review a file, select the file from the list.

  6. To add comments to a file:

    • Click and drag to select the lines where you want to add a comment.

    • In the Comment box, enter your comments. Optionally, format the comment using the toolbar or Markdown syntax.

    • Click Comment. Your comments are now visible to your team. Any responses are added in the same comment box. Each reviewer receives an email with a snippet of the code and the review comments.

  7. To vote to approve a pull request, click Approve. Enter the reasons for your approval and click Approve.

Back to top

Request changes to a pull request

If you are the reviewer of a pull request, you can ask for changes to the code.

When you add a comment, the pull request author and all the reviewers receive an email with a snippet of the code and the review comments.

Depending on the review rules, the pull request can be sent back to its author for rework. The author can make additional changes and republish the pull request. For details, see Review rules.

To request changes to a pull request:

  1. On the top navigation bar, select a space from the spaces list.

  2. (Optional) To restrict the scope of the search, open a product or Git repository and then a stream/branch.

  3. On the sidebar, select Reviews.
  4. Open a pull request from the review list.
  5. To vote for changes to be made, click Request Changes.
  6. Enter comments and click Request Changes.

Back to top

Bypass the pull request approval process

As an administrator, you can bypass the review of pull requests and instantly approve them or send them to their author for rework.

If the parent stream or branch has been configured to automatically merge, the approved pull request is merged into its parent stream or branch.

To approve a pull request or send it for rework as an administrator:

  1. On the top navigation bar, select a space from the spaces list.

  2. (Optional) To restrict the scope of the search, open a product or Git repository and then a stream/branch.

  3. On the sidebar, select Reviews.
  4. Open a pull request from the review list.
  5. To approve the pull request, click More in the in the upper-right corner of the page, and select Mark as Approved. To confirm, click Approve Review.

    To send the pull request for rework, click More and select Send for Rework. To confirm, click Send for Rework.

Back to top

See also: