diff --git a/assets/images/help/copilot/code-review/xcode-ccr-button.png b/assets/images/help/copilot/code-review/xcode-ccr-button.png new file mode 100644 index 0000000000..4d591809a5 Binary files /dev/null and b/assets/images/help/copilot/code-review/xcode-ccr-button.png differ diff --git a/assets/images/help/copilot/code-review/xcode-review-popup.png b/assets/images/help/copilot/code-review/xcode-review-popup.png new file mode 100644 index 0000000000..8a7b0d6088 Binary files /dev/null and b/assets/images/help/copilot/code-review/xcode-review-popup.png differ diff --git a/content/copilot/concepts/code-review/code-review.md b/content/copilot/concepts/code-review/code-review.md index 822152d822..d31b27357d 100644 --- a/content/copilot/concepts/code-review/code-review.md +++ b/content/copilot/concepts/code-review/code-review.md @@ -22,6 +22,14 @@ This article provides an overview of {% data variables.copilot.copilot_code-revi ## Availability +{% data variables.copilot.copilot_code-review_short %} is supported in: + +* {% data variables.product.prodname_dotcom_the_website %} +* {% data variables.product.prodname_mobile %} +* {% data variables.product.prodname_vscode_shortname %} +* {% data variables.product.prodname_vs %} +* Xcode + {% data variables.copilot.copilot_code-review_short %} is—with one exception—a premium feature, available with the {% data variables.copilot.copilot_pro_short %}, {% data variables.copilot.copilot_pro_plus_short %}, {% data variables.copilot.copilot_business_short %}, and {% data variables.copilot.copilot_enterprise_short %} plans. The exception is the review of a selection of code within a file in {% data variables.product.prodname_vscode %}. This is a standard feature available to all {% data variables.product.prodname_copilot_short %} users in {% data variables.product.prodname_vscode_shortname %}. diff --git a/content/copilot/how-tos/use-chat/use-chat-in-ide.md b/content/copilot/how-tos/use-chat/use-chat-in-ide.md index 0ab8af349e..f79b0a1cf8 100644 --- a/content/copilot/how-tos/use-chat/use-chat-in-ide.md +++ b/content/copilot/how-tos/use-chat/use-chat-in-ide.md @@ -487,7 +487,7 @@ To share feedback about {% data variables.copilot.copilot_chat_short %}, you can You can ask {% data variables.copilot.copilot_chat_short %} to give you code suggestions, explain code, generate unit tests, and suggest code fixes. -1. To open the chat view, click **Editor** in the menu bar, then click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}** then **Open Chat**. {% data variables.copilot.copilot_chat_short %} opens in a new window. +1. To open the chat view, click **Editor** in the menu bar, then click **{% data variables.product.prodname_copilot %}** then **Open Chat**. {% data variables.copilot.copilot_chat_short %} opens in a new window. 1. Enter a prompt in the prompt box. For example prompts, see [AUTOTITLE](/copilot/get-started/getting-started-with-prompts-for-copilot-chat). diff --git a/content/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review.md b/content/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review.md index 0f5f07f7b1..a5e9ee81be 100644 --- a/content/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review.md +++ b/content/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review.md @@ -28,7 +28,7 @@ For a full introduction to {% data variables.copilot.copilot_code-review %}, see ## Using {% data variables.copilot.copilot_code-review_short %} -These instructions explain how to use {% data variables.copilot.copilot_code-review_short %} in the {% data variables.product.github %} website. To see instructions for other popular coding environments, use the tool switcher at the top of the page. +These instructions explain how to use {% data variables.copilot.copilot_code-review_short %} in the {% data variables.product.github %} website. To see instructions for other popular coding environments, click the appropriate tab at the top of the page. 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 %}**. @@ -89,12 +89,6 @@ By default, you manually request a review from {% data variables.product.prodnam {% vscode %} -## Using {% data variables.copilot.copilot_code-review_short %} - -These instructions explain how to use {% data variables.copilot.copilot_code-review_short %} in {% data variables.product.prodname_vscode %}. To see instructions for other popular coding environments, use the tool switcher at the top of the page. - -> [!NOTE] {% data variables.copilot.copilot_code-review_short %} is available in {% data variables.product.prodname_vscode %} with version 0.22 or later of the {% data variables.copilot.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 %}. @@ -160,7 +154,7 @@ To use {% data variables.copilot.copilot_code-review_short %}, you must use {% d ## Using {% data variables.copilot.copilot_code-review_short %} -These instructions explain how to use {% data variables.copilot.copilot_code-review_short %} in {% data variables.product.prodname_vs %}. To see instructions for other popular coding environments, use the tool switcher at the top of the page. +These instructions explain how to use {% data variables.copilot.copilot_code-review_short %} in {% data variables.product.prodname_vs %}. To see instructions for other popular coding environments, click the appropriate tab at the top of the page. 1. In the Git Changes window, click **Review changes with {% data variables.product.prodname_copilot_short %}**. This button appears as a comment icon with a sparkle. @@ -182,7 +176,7 @@ For more information on enabling and configuring {% data variables.copilot.copil ## Using {% data variables.copilot.copilot_code-review_short %} -These instructions explain how to use {% data variables.copilot.copilot_code-review_short %} in {% data variables.product.prodname_mobile %}. To see instructions for other popular coding environments, use the tool switcher at the top of the page. +These instructions explain how to use {% data variables.copilot.copilot_code-review_short %} in {% data variables.product.prodname_mobile %}. To see instructions for other popular coding environments, click the appropriate tab at the top of the page. 1. In {% data variables.product.prodname_mobile %}, open a pull request. 1. Scroll down to the **Reviews** section and expand it. @@ -192,3 +186,34 @@ These instructions explain how to use {% data variables.copilot.copilot_code-rev {% data variables.product.prodname_copilot_short %} will review the changes and provide feedback. {% endmobile %} + +{% xcode %} + +## Prerequisite + +To use {% data variables.copilot.copilot_code-review_short %} in Xcode, you must use version 0.41.0 or later of the {% data variables.copilot.copilot_chat %} extension. Download the latest release from the [`github/CopilotForXcode` repository](https://github.com/github/CopilotForXcode/releases/latest). + +## Using {% data variables.copilot.copilot_code-review_short %} + +These instructions explain how to use {% data variables.copilot.copilot_code-review_short %} in Xcode. To see instructions for other popular coding environments, click the appropriate tab at the top of the page. + +1. In Xcode, make some changes to one or more files. +1. Open the {% data variables.product.prodname_copilot_short %} chat window by clicking **Editor** in the menu bar, clicking **{% data variables.product.prodname_copilot %}** then **Open Chat**. +1. Near the bottom right of the prompt box in the {% data variables.product.prodname_copilot_short %} chat window, click the **Code Review** button (a speech bubble icon). + + ![Screenshot of the {% data variables.product.prodname_copilot_short %} chat window in Xcode, with the 'Code Review' button outlined in dark orange.](/assets/images/help/copilot/code-review/xcode-ccr-button.png) + +1. Click either **Review Staged Changes** or **Review Unstaged Changes**. +1. A list of files containing changes is displayed in the chat window. Click the check boxes to deselect any files you don't want {% data variables.product.prodname_copilot_short %} to review. +1. Click **Continue** to start the review process. +1. If {% data variables.product.prodname_copilot_short %} finds things to comment on, it displays a **Reviewed Changes** list in the chat window, listing the files it has commented on. Click a file in this list to see the comments. + + Each comment is shown in a popup, overlaid over the editor. + + ![Screenshot of a {% data variables.copilot.copilot_code-review_short %} review comment.](/assets/images/help/copilot/code-review/xcode-review-popup.png) + +1. If there is more than one comment in the file, use the up and down arrows, at the top right of the popup, to navigate between comments. +1. {% data variables.product.prodname_copilot_short %} may suggest replacement code. You can apply the suggested change by clicking **Accept** or reject it by clicking **Dismiss**. +1. Click another file in the **Reviewed Changes** list in the chat window, to see the review comments for another file. + +{% endxcode %} diff --git a/content/copilot/responsible-use/code-review.md b/content/copilot/responsible-use/code-review.md index 6b388ca621..dbcfa1fae5 100644 --- a/content/copilot/responsible-use/code-review.md +++ b/content/copilot/responsible-use/code-review.md @@ -41,7 +41,7 @@ The language model generates a response based on its analysis of the input promp ### Output formatting -The response generated by {% data variables.product.prodname_copilot_short %} is presented to the user directly in {% data variables.product.prodname_vscode %} or as a pull request review on {% data variables.product.github %}, providing code feedback linked to specific lines of specific files. +The response generated by {% data variables.product.prodname_copilot_short %} is presented to the user either directly in the supported editor, or as a pull request review on {% data variables.product.github %}, providing code feedback linked to specific lines of specific files. Where {% data variables.product.prodname_copilot_short %} has provided a code suggestion, the suggestion is presented as a suggested change, which can be applied with a couple of clicks.