Merge pull request #40519 from github/repo-sync

Repo sync

Author: docs-bot

.github/workflows/stale.yml

@@ -24,7 +24,7 @@ jobs:
       - uses: actions/stale@3a9db7e6a41a89f618792c92c0e97cc736e1b13f # v10.0.0
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
-          stale-pr-message: "It looks as if this pull request has been inactive for 30 days. We want to check in with you to see if you plan to continue working on it. If you do, please add a comment to let us know. If we don't hear from you, we will close this pull request after 14 days."
+          stale-pr-message: "It looks as if this pull request has been inactive for 30 days. We want to check in with you to see if you plan to continue working on it. If you do, please add a comment to let us know. If we don't hear from you, we will close this pull request after 14 days. If the PR has been reviewed by a writer and you think it's ready to merge, drop into [#docs-content](https://github-grid.enterprise.slack.com/archives/C0E9DK082) and ask us to merge it."
           days-before-stale: 30
           days-before-close: 14
           stale-pr-label: 'stale'

content/copilot/concepts/agents/code-review.md

@@ -31,6 +31,7 @@ This article provides an overview of {% data variables.copilot.copilot_code-revi
 * {% data variables.product.prodname_vscode_shortname %}
 * {% data variables.product.prodname_vs %}
 * Xcode
+* JetBrains IDEs
 
 {% 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.
 

content/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review.md

@@ -209,3 +209,31 @@ These instructions explain how to use {% data variables.copilot.copilot_code-rev
 1. Click another file in the **Reviewed Changes** list in the chat window, to see the review comments for another file.
 
 {% endxcode %}
+
+{% jetbrains %}
+
+## Prerequisites
+
+* **Access to {% data variables.product.prodname_copilot_short %}**. {% data reusables.copilot.subscription-prerequisite %}
+
+* **Compatible JetBrains IDE**. To use {% data variables.product.prodname_copilot %} in JetBrains, you must have a compatible JetBrains IDE installed. {% data variables.product.prodname_copilot %} is compatible with the following IDEs:
+
+  {% data reusables.copilot.jetbrains-compatible-ides %}
+
+{% data reusables.copilot.jetbrains-plugin-prerequisites %}
+
+## Using {% data variables.copilot.copilot_code-review_short %}
+
+These instructions explain how to use {% data variables.copilot.copilot_code-review_short %} in JetBrains IDEs. To see instructions for other popular coding environments, click the appropriate tab at the top of the page.
+
+1. In a JetBrains IDE, make some changes to one or more files.
+1. Open the "Commit" tool window on the left-hand side.
+1. Above the commit message input field, click **Copilot: Review Code Changes**. This button appears as a magnifying glass icon with a sparkle.
+1. {% data variables.product.prodname_copilot_short %} will begin reviewing your changes.
+1. {% data variables.product.prodname_copilot_short %} displays comments in your code with a summary of each potential issue. You can:
+
+   * Review and make changes based on the suggestions.
+   * Dismiss a comment by clicking **Discard**.
+1. If there is more than one comment, use the up and down arrows, at the top right of the popup, to navigate between comments.
+
+{% endjetbrains %}

content/copilot/reference/ai-models/model-comparison.md

@@ -27,33 +27,35 @@ contentType: reference
 
 Use this table to find a suitable model quickly, see more detail in the sections below.
 
-| Model                                                 | Task area | Excels at (primary use case) | Additional capabilities | Further reading |
-|-------------------------------------------------------|-----------|-------------------------------|-----------------------|------------------|
-| {% data variables.copilot.copilot_gpt_41 %}           | General-purpose coding and writing | Fast, accurate code completions and explanations | Agent mode, vision    | [{% data variables.copilot.copilot_gpt_41 %} model card](https://openai.com/index/gpt-4-1/)|
-| {% data variables.copilot.copilot_gpt_5_mini %}       | Deep reasoning and debugging | Well-defined tasks and precise prompts | Reasoning, vision     | Not available |
-| {% data variables.copilot.copilot_gpt_5 %}            | Deep reasoning and debugging | Multi-step problem solving and architecture-level code analysis | Reasoning             | [{% data variables.copilot.copilot_gpt_5 %} model card](https://cdn.openai.com/pdf/8124a3ce-ab78-4f06-96eb-49ea29ffb52f/gpt5-system-card-aug7.pdf) |
-| {% data variables.copilot.copilot_o3 %}               | Deep reasoning and debugging | Multi-step problem solving and architecture-level code analysis | Reasoning             | [{% data variables.copilot.copilot_o3 %} model card](https://openai.com/index/o3-o4-mini-system-card/) |
-| {% data variables.copilot.copilot_o4_mini %}          | Fast help with simple or repetitive tasks | Fast, reliable answers to lightweight coding questions | Lower latency         | [{% data variables.copilot.copilot_o4_mini %} model card](https://openai.com/index/o3-o4-mini-system-card/) |
-| {% data variables.copilot.copilot_claude_opus_41 %}   | Deep reasoning and debugging | Complex problem-solving challenges, sophisticated reasoning | Reasoning, vision     | [{% data variables.copilot.copilot_claude_opus_41 %} model card](https://assets.anthropic.com/m/4c024b86c698d3d4/original/Claude-4-1-System-Card.pdf) |
-| {% data variables.copilot.copilot_claude_opus %}      | Deep reasoning and debugging | Complex problem-solving challenges, sophisticated reasoning | Reasoning, vision     | [{% data variables.copilot.copilot_claude_opus %} model card](https://www-cdn.anthropic.com/6be99a52cb68eb70eb9572b4cafad13df32ed995.pdf) |
-| {% data variables.copilot.copilot_claude_sonnet_35 %} | Fast help with simple or repetitive tasks | Quick responses for code, syntax, and documentation | Agent mode, vision    | [{% data variables.copilot.copilot_claude_sonnet_35 %} model card](https://www-cdn.anthropic.com/fed9cc193a14b84131812372d8d5857f8f304c52/Model_Card_Claude_3_Addendum.pdf) |
-| {% data variables.copilot.copilot_claude_sonnet_37 %} | Deep reasoning and debugging | Structured reasoning across large, complex codebases | Agent mode, vision    | [{% data variables.copilot.copilot_claude_sonnet_37 %} model card](https://assets.anthropic.com/m/785e231869ea8b3b/original/claude-3-7-sonnet-system-card.pdf) |
-| {% data variables.copilot.copilot_claude_sonnet_40 %} | Deep reasoning and debugging | Performance and practicality, perfectly balanced for coding workflows | Agent mode, vision    | [{% data variables.copilot.copilot_claude_sonnet_40 %} model card](https://www-cdn.anthropic.com/6be99a52cb68eb70eb9572b4cafad13df32ed995.pdf) |
-| {% data variables.copilot.copilot_gemini_25_pro %}    | Deep reasoning and debugging | Complex code generation, debugging, and research workflows | Reasoning, vision     | [{% data variables.copilot.copilot_gemini_25_pro %} model card](https://storage.googleapis.com/model-cards/documents/gemini-2.5-pro.pdf) |
-| {% data variables.copilot.copilot_gemini_flash %}     | Working with visuals (diagrams, screenshots) | Real-time responses and visual reasoning for UI and diagram-based tasks | Vision                | [{% data variables.copilot.copilot_gemini_flash %} model card](https://storage.googleapis.com/model-cards/documents/gemini-2-flash.pdf) |
-| {% data variables.copilot.copilot_grok_code %}        | General-purpose coding and writing | Fast, accurate code completions and explanations | Agent mode      | [{% data variables.copilot.copilot_grok_code %} model card](https://data.x.ai/2025-08-20-grok-4-model-card.pdf)|
+| Model                                                 | Task area | Excels at (primary use case) | Additional capabilities | Further reading                                                                                                                                                             |
+|-------------------------------------------------------|-----------|-------------------------------|-------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| {% data variables.copilot.copilot_gpt_41 %}           | General-purpose coding and writing | Fast, accurate code completions and explanations | Agent mode, vision      | [{% data variables.copilot.copilot_gpt_41 %} model card](https://openai.com/index/gpt-4-1/)                                                                                 |
+| {% data variables.copilot.copilot_gpt_5_codex %}      | General-purpose coding and writing | Fast, accurate code completions and explanations | Agent mode               | [{% data variables.copilot.copilot_gpt_5_codex %} model card](https://cdn.openai.com/pdf/97cc5669-7a25-4e63-b15f-5fd5bdc4d149/gpt-5-codex-system-card.pdf)                  |
+| {% data variables.copilot.copilot_gpt_5_mini %}       | Deep reasoning and debugging | Well-defined tasks and precise prompts | Reasoning, vision       | Not available                                                                                                                                                               |
+| {% data variables.copilot.copilot_gpt_5 %}            | Deep reasoning and debugging | Multi-step problem solving and architecture-level code analysis | Reasoning               | [{% data variables.copilot.copilot_gpt_5 %} model card](https://cdn.openai.com/pdf/8124a3ce-ab78-4f06-96eb-49ea29ffb52f/gpt5-system-card-aug7.pdf)                          |
+| {% data variables.copilot.copilot_o3 %}               | Deep reasoning and debugging | Multi-step problem solving and architecture-level code analysis | Reasoning               | [{% data variables.copilot.copilot_o3 %} model card](https://openai.com/index/o3-o4-mini-system-card/)                                                                      |
+| {% data variables.copilot.copilot_o4_mini %}          | Fast help with simple or repetitive tasks | Fast, reliable answers to lightweight coding questions | Lower latency           | [{% data variables.copilot.copilot_o4_mini %} model card](https://openai.com/index/o3-o4-mini-system-card/)                                                                 |
+| {% data variables.copilot.copilot_claude_opus_41 %}   | Deep reasoning and debugging | Complex problem-solving challenges, sophisticated reasoning | Reasoning, vision       | [{% data variables.copilot.copilot_claude_opus_41 %} model card](https://assets.anthropic.com/m/4c024b86c698d3d4/original/Claude-4-1-System-Card.pdf)                       |
+| {% data variables.copilot.copilot_claude_opus %}      | Deep reasoning and debugging | Complex problem-solving challenges, sophisticated reasoning | Reasoning, vision       | [{% data variables.copilot.copilot_claude_opus %} model card](https://www-cdn.anthropic.com/6be99a52cb68eb70eb9572b4cafad13df32ed995.pdf)                                   |
+| {% data variables.copilot.copilot_claude_sonnet_35 %} | Fast help with simple or repetitive tasks | Quick responses for code, syntax, and documentation | Agent mode, vision      | [{% data variables.copilot.copilot_claude_sonnet_35 %} model card](https://www-cdn.anthropic.com/fed9cc193a14b84131812372d8d5857f8f304c52/Model_Card_Claude_3_Addendum.pdf) |
+| {% data variables.copilot.copilot_claude_sonnet_37 %} | Deep reasoning and debugging | Structured reasoning across large, complex codebases | Agent mode, vision      | [{% data variables.copilot.copilot_claude_sonnet_37 %} model card](https://assets.anthropic.com/m/785e231869ea8b3b/original/claude-3-7-sonnet-system-card.pdf)              |
+| {% data variables.copilot.copilot_claude_sonnet_40 %} | Deep reasoning and debugging | Performance and practicality, perfectly balanced for coding workflows | Agent mode, vision      | [{% data variables.copilot.copilot_claude_sonnet_40 %} model card](https://www-cdn.anthropic.com/6be99a52cb68eb70eb9572b4cafad13df32ed995.pdf)                              |
+| {% data variables.copilot.copilot_gemini_25_pro %}    | Deep reasoning and debugging | Complex code generation, debugging, and research workflows | Reasoning, vision       | [{% data variables.copilot.copilot_gemini_25_pro %} model card](https://storage.googleapis.com/model-cards/documents/gemini-2.5-pro.pdf)                                    |
+| {% data variables.copilot.copilot_gemini_flash %}     | Working with visuals (diagrams, screenshots) | Real-time responses and visual reasoning for UI and diagram-based tasks | Vision                  | [{% data variables.copilot.copilot_gemini_flash %} model card](https://storage.googleapis.com/model-cards/documents/gemini-2-flash.pdf)                                     |
+| {% data variables.copilot.copilot_grok_code %}        | General-purpose coding and writing | Fast, accurate code completions and explanations | Agent mode              | [{% data variables.copilot.copilot_grok_code %} model card](https://data.x.ai/2025-08-20-grok-4-model-card.pdf)                                                             |
 
 ## Task: General-purpose coding and writing
 
 Use these models for common development tasks that require a balance of quality, speed, and cost efficiency. These models are a good default when you don't have specific requirements.
 
-| Model                                                 | Why it's a good fit                                                                                                  |
-|-------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------|
-| {% data variables.copilot.copilot_gpt_41 %}           | Reliable default for most coding and writing tasks. Fast, accurate, and works well across languages and frameworks.  |
-| {% data variables.copilot.copilot_claude_sonnet_37 %} | Produces clear, structured output. Follows formatting instructions and maintains consistent style.                   |
-| {% data variables.copilot.copilot_gemini_flash %}     | Fast and cost-effective. Well suited for quick questions, short code snippets, and lightweight writing tasks.        |
-| {% data variables.copilot.copilot_o4_mini %}          | Optimized for speed and cost efficiency. Ideal for real-time suggestions with low usage overhead.                    |
-| {% data variables.copilot.copilot_grok_code %}        | Specialized for coding tasks. Performs well on code generation, and debugging across multiple languages.             |
+| Model                                                 | Why it's a good fit                                                                                                                             |
+|-------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------|
+| {% data variables.copilot.copilot_gpt_41 %}           | Reliable default for most coding and writing tasks. Fast, accurate, and works well across languages and frameworks.                             |
+| {% data variables.copilot.copilot_gpt_5_codex %}      | Delivers higher-quality code on complex engineering tasks like features, tests, debugging, refactors, and reviews without lengthy instructions. |
+| {% data variables.copilot.copilot_claude_sonnet_37 %} | Produces clear, structured output. Follows formatting instructions and maintains consistent style.                                              |
+| {% data variables.copilot.copilot_gemini_flash %}     | Fast and cost-effective. Well suited for quick questions, short code snippets, and lightweight writing tasks.                                   |
+| {% data variables.copilot.copilot_o4_mini %}          | Optimized for speed and cost efficiency. Ideal for real-time suggestions with low usage overhead.                                               |
+| {% data variables.copilot.copilot_grok_code %}        | Specialized for coding tasks. Performs well on code generation, and debugging across multiple languages.                                        |
 
 ### When to use these models
 

content/copilot/reference/ai-models/model-hosting.md

@@ -19,14 +19,15 @@ contentType: reference
 Used for:
 
 * {% data variables.copilot.copilot_gpt_41 %}
+* {% data variables.copilot.copilot_gpt_5_codex %} (supported in {% data variables.product.prodname_vscode %} v1.104.1 or higher)
 * {% data variables.copilot.copilot_gpt_5_mini %}
 * {% data variables.copilot.copilot_gpt_5 %}
 * {% data variables.copilot.copilot_o3 %}
 * {% data variables.copilot.copilot_o4_mini %}
 
 {% data variables.copilot.copilot_gpt_41 %} is hosted by {% data variables.product.github %}'s Azure tenant when used in {% data variables.product.prodname_copilot %}.
 
-{% data variables.copilot.copilot_gpt_5 %}, {% data variables.copilot.copilot_gpt_5_mini %}, {% data variables.copilot.copilot_o3 %} and {% data variables.copilot.copilot_o4_mini %} models are hosted by OpenAI and {% data variables.product.github %}'s Azure tenant. OpenAI makes the [following data commitment](https://openai.com/enterprise-privacy/): _We [OpenAI] do not train our models on your business data by default_. {% data variables.product.github %} maintains a [zero data retention agreement](https://platform.openai.com/docs/guides/your-data) with OpenAI.
+{% data variables.copilot.copilot_gpt_5_codex %}, {% data variables.copilot.copilot_gpt_5 %}, {% data variables.copilot.copilot_gpt_5_mini %}, {% data variables.copilot.copilot_o3 %} and {% data variables.copilot.copilot_o4_mini %} models are hosted by OpenAI and {% data variables.product.github %}'s Azure tenant. OpenAI makes the [following data commitment](https://openai.com/enterprise-privacy/): _We [OpenAI] do not train our models on your business data by default_. {% data variables.product.github %} maintains a [zero data retention agreement](https://platform.openai.com/docs/guides/your-data) with OpenAI.
 
 When using OpenAI's models, input requests and output responses continue to run through {% data variables.product.prodname_copilot %}'s content filters for public code matching, when applied, along with those for harmful or offensive content.