[EDI 5521 - Builders] Update docs for switching the Copilot code completion LLM (#56693)

Co-authored-by: Copilot <[email protected]>
Co-authored-by: Sophie <[email protected]>

Author: 3 people

content/copilot/concepts/completions/code-suggestions.md

@@ -87,6 +87,80 @@ topics:
 
 {% data variables.product.prodname_copilot %} checks each suggestion for matches with publicly available code. Any matches are discarded or suggested with a code reference, based on the setting of the "Suggestions matching public code" policy for your account or organization. See [AUTOTITLE](/copilot/concepts/completions/code-referencing).
 
+## About the AI model used for {% data variables.product.prodname_copilot_short %} code completion
+
+{% data variables.product.prodname_copilot_short %} code completion uses the {% data variables.copilot.copilot_gpt_4o %} {% data variables.product.prodname_copilot_short %} model. This is a fine-tuned version of the GPT-4o mini model. The {% data variables.copilot.copilot_gpt_4o %} {% data variables.product.prodname_copilot_short %} model was trained on a wide range of high quality public {% data variables.product.github %} repositories, providing coverage of over 30 programming languages. See [Programming languages included in the default model](#programming-languages-included-in-the-default-model) below.
+
+{% vscode %}
+
+## Changing the model used for code completion
+
+{% data reusables.copilot.code-completion-switch-prereqs-vscode %}
+
+Changing the model only affects {% data variables.product.prodname_copilot_short %} code completion. It does not affect {% data variables.product.prodname_copilot_short %} next edit suggestions.
+
+{% data reusables.copilot.code-completion-switch-model-affects %}
+
+{% endvscode %}
+
+{% visualstudio %}
+
+## Changing the model used for code completion
+
+{% data reusables.copilot.code-completion-switch-prereqs-vs %}
+
+{% data reusables.copilot.code-completion-switch-model-affects %}
+
+{% endvisualstudio %}
+
+{% jetbrains %}
+
+## Changing the model used for code completion
+
+{% data reusables.copilot.code-completion-switch-prereqs-jetbrains %}
+
+{% data reusables.copilot.code-completion-switch-model-affects %}
+
+{% endjetbrains %}
+
+## Programming languages included in the default model
+
+The following programming languages and technologies are included in the training data for the default LLM used for {% data variables.product.prodname_copilot_short %} code completion:
+
+  * C
+  * C#
+  * C++
+  * Clojure
+  * CSS
+  * Dart
+  * Dockerfile
+  * Elixir
+  * Emacs Lisp
+  * Go
+  * Haskell
+  * HTML
+  * Java
+  * JavaScript
+  * Julia
+  * Jupyter Notebook
+  * Kotlin
+  * Lua
+  * MATLAB
+  * Objective-C
+  * Perl
+  * PHP
+  * PowerShell
+  * Python
+  * R
+  * Ruby
+  * Rust
+  * Scala
+  * Shell
+  * Swift
+  * TeX
+  * TypeScript
+  * Vue
+
 ## Next steps
 
 * [AUTOTITLE](/copilot/how-tos/completions/getting-code-suggestions-in-your-ide-with-github-copilot)

content/copilot/how-tos/ai-models/changing-the-ai-model-for-copilot-code-completion.md

@@ -10,90 +10,24 @@ redirect_from:
   - /copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-code-completion
 ---
 
-## Overview
-
-By default, {% data variables.product.prodname_copilot_short %} code completion uses the {% data variables.copilot.copilot_gpt_4o %} {% data variables.product.prodname_copilot_short %} model. This is a fine-tuned version of the GPT-4o mini model. The {% data variables.copilot.copilot_gpt_4o %} {% data variables.product.prodname_copilot_short %} model was trained on a wide range of high quality public {% data variables.product.github %} repositories, providing coverage of over 30 programming languages.
-
-<details>
-  <summary>View the list of programming languages and technologies included in the training data.</summary>
-
-  * C
-  * C#
-  * C++
-  * Clojure
-  * CSS
-  * Dart
-  * Dockerfile
-  * Elixir
-  * Emacs Lisp
-  * Go
-  * Haskell
-  * HTML
-  * Java
-  * JavaScript
-  * Julia
-  * Jupyter Notebook
-  * Kotlin
-  * Lua
-  * MATLAB
-  * Objective-C
-  * Perl
-  * PHP
-  * PowerShell
-  * Python
-  * R
-  * Ruby
-  * Rust
-  * Scala
-  * Shell
-  * Swift
-  * TeX
-  * TypeScript
-  * Vue
-
-</details>
-
-{% vscode %} You can switch AI models in the latest releases of {% data variables.product.prodname_vscode_shortname %} with the latest version of the {% data variables.product.prodname_copilot %} extension. {% endvscode %}
-
-{% visualstudio %} You can switch AI models in {% data variables.product.prodname_vs %} 17.14 Preview 2 and later. {% endvisualstudio %}
-
-{% jetbrains %} You can switch AI models in the latest releases of JetBrains IDEs with the latest version of the {% data variables.product.prodname_copilot %} extension. {% endjetbrains %}
-
-> [!NOTE]
-> The list of available models will change over time. When only one code completion model is available, the model picker will only show that model. Preview models and additional code completion models will be added to the picker as they become available.
-
-## Effects of switching the AI model
-
-Changing the model that's used for {% data variables.product.prodname_copilot_short %} code completion does not affect the model that's used by {% data variables.copilot.copilot_chat_short %}. See [AUTOTITLE](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat).
-
-There are no changes to the data collection and usage policy if you change the AI model.
-
-If you are on a {% data variables.copilot.copilot_free_short %} plan, all completions count against your completions quota regardless of the model used. See [AUTOTITLE](/copilot/about-github-copilot/subscription-plans-for-github-copilot#comparing-copilot-subscriptions).
-
-The setting to enable or disable suggestions that match public code are applied irrespective of which model you choose. See [AUTOTITLE](/enterprise-cloud@latest/copilot/using-github-copilot/finding-public-code-that-matches-github-copilot-suggestions).
-
-## Enabling the model switcher
+{% vscode %}
 
-{% ifversion fpt %}
+The following instructions are for {% data variables.product.prodname_vscode_shortname %}. If you are using {% data variables.product.prodname_vs %}, or a JetBrains IDE, click the appropriate tab at the start of this article.
 
-If you have a {% data variables.copilot.copilot_free_short %} or {% data variables.copilot.copilot_pro_short %} plan, the model switcher for {% data variables.product.prodname_copilot_short %} code completion is automatically enabled.
+## Prerequisites
 
-{% endif %}
+{% data reusables.copilot.code-completion-switch-prereqs-vscode %}
 
-{% data reusables.copilot.editor-preview-settings %}
+{% data reusables.copilot.code-completion-available-models %}
 
-{% vscode %}
+For more information, see [AUTOTITLE](/copilot/concepts/completions/code-suggestions#changing-the-model-used-for-code-completion).
 
 ## Changing the AI model for code completion
 
-The following instructions are for {% data variables.product.prodname_vscode_shortname %}. If you are using {% data variables.product.prodname_vs %}, or a JetBrains IDE, click the appropriate tab at the start of this article.
-
 1. Open the command palette by pressing <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (Windows/Linux) / <kbd>Command</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (Mac).
 1. Type `change completions model` and select the "{% data variables.product.prodname_copilot %}: Change Completions Model" command.
 1. In the dropdown menu, select the model you want to use.
 
-Alternatively, if Command Center is enabled, you can click {% octicon "chevron-down" aria-label="The downward-pointing arrowhead" %} beside the **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %}** icon at the top of the {% data variables.product.prodname_vscode_shortname %} window, then click **Configure Code Completions** in the dropdown menu. Then choose **Change Completions Model** in the dropdown menu and select the model you want to use.
-
 ## Checking which model is being used
 
 1. Open the Settings editor by pressing <kbd>Ctrl</kbd>+<kbd>,</kbd> (Linux/Windows) / <kbd>Command</kbd>+<kbd>,</kbd> (Mac).
@@ -105,10 +39,18 @@ Alternatively, if Command Center is enabled, you can click {% octicon "chevron-d
 
 {% visualstudio %}
 
-## Changing the AI model for code completion
-
 The following instructions are for {% data variables.product.prodname_vs %}. If you are using {% data variables.product.prodname_vscode_shortname %}, or a JetBrains IDE, click the appropriate tab at the start of this article.
 
+## Prerequisites
+
+{% data reusables.copilot.code-completion-switch-prereqs-vs %}
+
+{% data reusables.copilot.code-completion-available-models %}
+
+For more information, see [AUTOTITLE](/copilot/concepts/completions/code-suggestions#changing-the-model-used-for-code-completion).
+
+## Changing the AI model for code completion
+
 1. Click the **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %}** icon in the top right corner.
 1. Click **Settings**, then click **Options**.
 1. Under **{% data variables.product.prodname_copilot_short %} Completions**, use the dropdown menu to select the model you want to use.
@@ -117,10 +59,18 @@ The following instructions are for {% data variables.product.prodname_vs %}. If
 
 {% jetbrains %}
 
-## Changing the AI model for code completion
-
 The following instructions are for JetBrains IDEs. If you are using {% data variables.product.prodname_vs %}, or {% data variables.product.prodname_vscode_shortname %}, click the appropriate tab at the start of this article.
 
+## Prerequisites
+
+{% data reusables.copilot.code-completion-switch-prereqs-jetbrains %}
+
+{% data reusables.copilot.code-completion-available-models %}
+
+For more information, see [AUTOTITLE](/copilot/concepts/completions/code-suggestions#changing-the-model-used-for-code-completion).
+
+## Changing the AI model for code completion
+
 1. Click the **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %}** icon in the status bar.
 1. In the popup menu, click **Edit Model for Completion**.
 1. In the settings dialog box for "Languages & Frameworks > {% data variables.product.prodname_copilot %}," click the dropdown menu for **Model for completions** and select the model you want to use.

data/reusables/copilot/code-completion-available-models.md

@@ -0,0 +1 @@
+> [!NOTE] The list of available models will change over time. When only one code completion model is available, the model picker will only show that model. Preview models and additional code completion models will be added to the picker as they become available.

data/reusables/copilot/code-completion-switch-model-affects.md

@@ -0,0 +1,19 @@
+> [!NOTE] The list of available models will change over time. When only one code completion model is available, the model picker will only show that model. Preview models and additional code completion models will be added to the picker as they become available.
+
+For details of how to switch the model for {% data variables.product.prodname_copilot_short %} code completion, see [AUTOTITLE](/copilot/how-tos/ai-models/changing-the-ai-model-for-copilot-code-completion).
+
+## Effects of switching the AI model
+
+Changing the model that's used for {% data variables.product.prodname_copilot_short %} code completion does not affect the model that's used by {% data variables.product.prodname_copilot_short %} next edit suggestions or {% data variables.copilot.copilot_chat_short %}. See [AUTOTITLE](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat).
+
+There are no changes to the data collection and usage policy if you change the AI model.
+
+If you are on a {% data variables.copilot.copilot_free_short %} plan, all completions count against your completions quota regardless of the model used. See [AUTOTITLE](/copilot/about-github-copilot/subscription-plans-for-github-copilot#comparing-copilot-subscriptions).
+
+The setting to enable or disable suggestions that match public code are applied irrespective of which model you choose. See [AUTOTITLE](/copilot/using-github-copilot/finding-public-code-that-matches-github-copilot-suggestions).
+
+## Enabling the model switcher
+
+If you have a {% data variables.copilot.copilot_free_short %} or {% data variables.copilot.copilot_pro_short %} plan, the model switcher for {% data variables.product.prodname_copilot_short %} code completion is automatically enabled.
+
+{% data reusables.copilot.editor-preview-settings %}

data/reusables/copilot/code-completion-switch-prereqs-jetbrains.md

@@ -0,0 +1,4 @@
+You can switch the AI model that's used by {% data variables.product.prodname_copilot_short %} code completion if:
+
+* An alternative model is currently available
+* You are using the latest release of JetBrains IDEs with the latest version of the {% data variables.product.prodname_copilot %} extension

data/reusables/copilot/code-completion-switch-prereqs-vs.md

@@ -0,0 +1,4 @@
+You can switch the AI model that's used by {% data variables.product.prodname_copilot_short %} code completion if:
+
+* An alternative model is currently available
+* You are using {% data variables.product.prodname_vs %} 17.14 Preview 2 or later

data/reusables/copilot/code-completion-switch-prereqs-vscode.md

@@ -0,0 +1,4 @@
+You can switch the AI model that's used by {% data variables.product.prodname_copilot_short %} code completion if:
+
+* An alternative model is currently available
+* You are using the latest releases of {% data variables.product.prodname_vscode_shortname %} with the latest version of the {% data variables.product.prodname_copilot %} extension