202 lines
16 KiB
Markdown
202 lines
16 KiB
Markdown
---
|
|
title: Using GitHub Copilot code review
|
|
shortTitle: Using code review
|
|
intro: "Learn how to request a code review from {% data variables.product.prodname_copilot %}."
|
|
allowTitleToDifferFromFilename: true
|
|
product: 'See the table below.'
|
|
versions:
|
|
feature: copilot
|
|
topics:
|
|
- Copilot
|
|
redirect_from:
|
|
- /early-access/copilot/code-review/using-copilot-code-review
|
|
- /early-access/copilot/code-reviews/using-copilot-code-review
|
|
- /early-access/copilot/code-reviews/using-copilot-code-reviews
|
|
---
|
|
|
|
>[!NOTE]
|
|
> {% data reusables.copilot.code-review.preview-note %}
|
|
|
|
## Receiving access
|
|
|
|
{% webui %}
|
|
|
|
If you get a {% data variables.product.prodname_copilot_short %} subscription from an organization, you will only be able to participate in the {% data variables.release-phases.public_preview %} on the {% data variables.product.github %} website if an owner of your organization has enabled **{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %} > Opt in to preview features** in the organization policies. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization).
|
|
|
|
{% endwebui %}
|
|
|
|
{% vscode %}
|
|
|
|
If you get a {% data variables.product.prodname_copilot_short %} subscription from an organization, you will only be able to participate in the {% data variables.release-phases.public_preview %} in {% data variables.product.prodname_vscode_shortname %} if an owner of your organization has enabled **Editor preview features** in the organization policies. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization).
|
|
|
|
{% endvscode %}
|
|
|
|
If an enterprise owner has explicitly enabled or disabled preview features, organizations in the enterprise will not be able to change the policy. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise).
|
|
|
|
## About {% data variables.copilot.copilot_code-review_short %}
|
|
|
|
{% data variables.product.prodname_copilot %} can review your code and provide feedback. Where possible, {% data variables.product.prodname_copilot_short %}'s feedback includes suggested changes which you can apply with a couple of clicks.
|
|
|
|
{% data variables.copilot.copilot_code-review_short %} supports two types of review:
|
|
|
|
* **Review selection:** Highlight code and ask for an initial review _({% data variables.product.prodname_vscode %} only)_
|
|
* **Review changes:** Request a deeper review of all your changes _({% data variables.product.github %} website and {% data variables.product.prodname_vscode %})_
|
|
|
|
The current functionality and availability of the two types of review is summarized in the following table:
|
|
|
|
{% rowheaders %}
|
|
|
|
| Feature | Review selection | Review changes |
|
|
| --------- | ----------------- | --------------- |
|
|
| Environment | {% data variables.product.prodname_vscode %} | {% data variables.product.prodname_vscode %} and the {% data variables.product.github %} website |
|
|
| Description | Initial review of a highlighted section of code with feedback and suggestions | Deeper review of all changes |
|
|
| Language support | All | C#, Go, Java, JavaScript, Markdown, Python, Ruby, TypeScript |
|
|
| Custom coding guidelines support | No | Yes, see [Customizing {% data variables.product.prodname_copilot_short %}'s reviews with coding guidelines](#customizing-copilots-reviews-with-coding-guidelines) |
|
|
| Availability | {% data variables.release-phases.public_preview_caps %}, available to all {% data variables.product.prodname_copilot_short %} subscribers | {% data variables.release-phases.public_preview_caps %}, available with {% data variables.product.prodname_copilot_pro_short %}, {% data variables.product.prodname_copilot_business_short %}, and {% data variables.product.prodname_copilot_enterprise_short %} subscriptions. |
|
|
|
|
{% endrowheaders %}
|
|
|
|
> [!WARNING] {% data variables.product.prodname_copilot_short %} isn't guaranteed to spot all problems or issues in a pull request, and sometimes it will make mistakes. Always validate {% data variables.product.prodname_copilot_short %}'s feedback carefully, and supplement {% data variables.product.prodname_copilot_short %}'s feedback with a human review.
|
|
|
|
For more information, see [AUTOTITLE](/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-code-review).
|
|
|
|
## Requesting a review from {% data variables.product.prodname_copilot_short %}
|
|
|
|
{% webui %}
|
|
|
|
These instructions explain how to use {% data variables.copilot.copilot_code-review_short %} in the {% data variables.product.github %} website. To see instructions for {% data variables.product.prodname_vscode %}, use the "{% data variables.product.prodname_vscode %}" tool switcher at the top of the page.
|
|
|
|
### Requesting a pull request review from {% data variables.product.prodname_copilot_short %}
|
|
|
|
> [!NOTE]
|
|
> To access the {% data variables.release-phases.public_preview %} of this feature, see [Join the preview for {% data variables.copilot.copilot_code-review_short %}-powered code reviews](https://gh.io/copilot-code-review-waitlist).
|
|
|
|
1. On {% data variables.product.prodname_dotcom_the_website %}, create a pull request or navigate to an existing pull request.
|
|
1. Open the **Reviewers** menu, then select **{% data variables.product.prodname_copilot_short %}**.
|
|
|
|
|
|
|
|
1. Wait for {% data variables.product.prodname_copilot_short %} to review your pull request. This usually takes less than 30 seconds.
|
|
|
|
1. Scroll down and read through {% data variables.product.prodname_copilot_short %}'s comments.
|
|
|
|
|
|
|
|
{% data variables.product.prodname_copilot_short %} always leaves a "Comment" review, not an "Approve" review or a "Request changes" review. This means that {% data variables.product.prodname_copilot_short %}'s reviews do not count toward required reviews for the pull request, and {% data variables.product.prodname_copilot_short %}'s reviews will not block merging changes. For more details, see [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/approving-a-pull-request-with-required-reviews).
|
|
|
|
1. {% data variables.product.prodname_copilot_short %}'s review comments behave like review comments from humans. You can add reactions to them, comment on them, resolve them and hide them.
|
|
|
|
Any comments you add to {% data variables.product.prodname_copilot_short %}'s review comments will be visible to humans, but they won't be visible to {% data variables.product.prodname_copilot_short %}, and {% data variables.product.prodname_copilot_short %} won't reply.
|
|
|
|
## Working with suggested changes provided by {% data variables.product.prodname_copilot_short %}
|
|
|
|
Where possible, {% data variables.product.prodname_copilot_short %}'s feedback includes suggested changes which you can apply with a couple of clicks.
|
|
|
|
If you're happy with the changes, you can accept a single suggestion from {% data variables.product.prodname_copilot_short %} and commit it, or accept a group of suggestions together in a single commit. For more information, see [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/incorporating-feedback-in-your-pull-request).
|
|
|
|
If you want to validate {% data variables.product.prodname_copilot_short %}'s suggested changes (for example by running automated tests or your linter), or if you want to make modifications before committing the suggested changes, click the **Open in Workspace** button. For more information, see [AUTOTITLE](/copilot/using-github-copilot/using-github-copilot-for-pull-requests/using-copilot-to-help-you-work-on-a-pull-request).
|
|
|
|
## Providing feedback on {% data variables.product.prodname_copilot_short %}'s reviews
|
|
|
|
You can provide feedback on {% data variables.product.prodname_copilot_short %}'s comments directly within each comment. We use this information to improve the product and the quality of {% data variables.product.prodname_copilot_short %}'s suggestions.
|
|
|
|
1. On a pull request review comment from {% data variables.product.prodname_copilot_short %}, click the thumbs up (:+1:) or thumbs down (:-1:) button.
|
|
|
|
|
|
|
|
1. If you click the thumbs down button, you're asked to provide additional information. You can, optionally, pick the reason for your negative feedback and leave a comment before clicking **Submit feedback**.
|
|
|
|
|
|
|
|
## Requesting a re-review from {% data variables.product.prodname_copilot_short %}
|
|
|
|
When you push changes to a pull request that {% data variables.product.prodname_copilot_short %} has reviewed, it won't automatically re-review your changes.
|
|
|
|
To request a re-review from {% data variables.product.prodname_copilot_short %}, click the {% octicon "sync" aria-label="Re-request review" %} button next to {% data variables.product.prodname_copilot_short %}'s name in the **Reviewers** menu. For more information, see [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/requesting-a-pull-request-review).
|
|
|
|
> [!NOTE] When re-reviewing a pull request, {% data variables.product.prodname_copilot_short %} may repeat the same comments again, even if they have been dismissed with the "Resolve conversation" button or downvoted with the thumbs down (:-1:) button.
|
|
|
|
## Enabling automatic reviews
|
|
|
|
By default, you manually request a review from {% data variables.product.prodname_copilot_short %} on each pull request, in the same way you would request a review from a human. However, you can set up {% data variables.product.prodname_copilot_short %} to automatically review all pull requests in a repository, or for all repositories in an organization. See [AUTOTITLE](/copilot/using-github-copilot/code-review/configuring-automatic-code-review-by-copilot).
|
|
|
|
## Customizing {% data variables.product.prodname_copilot_short %}'s reviews with coding guidelines
|
|
|
|
{% data reusables.copilot.code-review.custom-coding-guidelines %}
|
|
|
|
{% endwebui %}
|
|
|
|
{% vscode %}
|
|
|
|
These instructions explain how to use {% data variables.copilot.copilot_code-review_short %} in {% data variables.product.prodname_vscode %}. To see instructions for the {% data variables.product.github %} website, use the "Web browser" tool switcher at the top of the page.
|
|
|
|
> [!NOTE] {% data variables.copilot.copilot_code-review_short %} is only available in {% data variables.product.prodname_vscode %} with version 0.22 or later of the {% data variables.product.prodname_copilot_chat %} extension.
|
|
|
|
### Reviewing a selection of code
|
|
|
|
You can request an initial review of a highlighted selection of code in {% data variables.product.prodname_vscode %}.
|
|
|
|
1. In {% data variables.product.prodname_vscode %}, select the code you want to review.
|
|
1. Open the {% data variables.product.prodname_vscode_command_palette_shortname %}
|
|
* For Mac:
|
|
* Use: <kbd>Shift</kbd>+<kbd>Command</kbd>+<kbd>P</kbd>
|
|
* For Windows or Linux:
|
|
* Use <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd>
|
|
1. In the command palette, search for and select **{% data variables.product.prodname_copilot %}: Review and Comment**.
|
|
|
|
|
|
|
|
1. Wait for {% data variables.product.prodname_copilot_short %} to review your changes. This usually takes less than 30 seconds.
|
|
|
|
|
|
|
|
1. If {% data variables.product.prodname_copilot_short %} has any comments, they will be shown inline in your file, and in the **Problems** tab.
|
|
|
|
|
|
|
|
### Reviewing changes
|
|
|
|
> [!NOTE]
|
|
> To access the {% data variables.release-phases.public_preview %} of this feature, see [Join the preview for {% data variables.copilot.copilot_code-review_short %}-powered code reviews](https://gh.io/copilot-code-review-waitlist).
|
|
|
|
You can request a review for your staged or unstaged changes in {% data variables.product.prodname_vscode %}.
|
|
|
|
1. In {% data variables.product.prodname_vscode_shortname %}, switch to the **Source Control** tab.
|
|
1. To request a review on your unstaged changes, hover over **Changes** in the sidebar, and then click the {% data reusables.copilot.code-review.staging-icon-vscode %} **{% data variables.copilot.copilot_code-review_short %} - Changes** button.
|
|
|
|
|
|
|
|
1. To request a review on your staged changes, hover over **Staged Changes** in the sidebar, and then click the {% data reusables.copilot.code-review.staging-icon-vscode %} **{% data variables.copilot.copilot_code-review_short %} - Staged Changes** button.
|
|
|
|
1. Wait for {% data variables.product.prodname_copilot_short %} to review your changes. This usually takes less than 30 seconds.
|
|
|
|
|
|
|
|
1. If {% data variables.product.prodname_copilot_short %} has any comments, they will be shown inline in your file(s), and in the **Problems** tab.
|
|
|
|
|
|
|
|
## Working with suggested changes provided by {% data variables.product.prodname_copilot_short %}
|
|
|
|
Where possible, {% data variables.product.prodname_copilot_short %}'s feedback includes suggested changes which you can apply with a single click.
|
|
|
|
|
|
|
|
If you're happy with the change, you can accept a suggestion from {% data variables.product.prodname_copilot_short %} by clicking the **Apply and Go To Next** button. Any changes you apply will not be automatically committed.
|
|
|
|
If you don't want to apply {% data variables.product.prodname_copilot_short %}'s suggested change, click the **Discard and Go to Next** button.
|
|
|
|
## Providing feedback on {% data variables.product.prodname_copilot_short %}'s reviews
|
|
|
|
You can provide feedback on {% data variables.product.prodname_copilot_short %}'s comments directly within each comment. We use this information to improve the product and the quality of {% data variables.product.prodname_copilot_short %}'s suggestions.
|
|
|
|
To provide feedback, hover over the comment and click the thumbs up or thumbs down button.
|
|
|
|
|
|
|
|
## Customizing {% data variables.product.prodname_copilot_short %}'s reviews with coding guidelines
|
|
|
|
{% data reusables.copilot.code-review.custom-coding-guidelines %}
|
|
|
|
{% endvscode %}
|