Skip to content

Commit 3e31eb6

Browse files
bamurtaughBrigit Murtaughntrogh
authored
Update inline suggestions terminology (#9000)
* Initial suggestions updates * Rename ToC entry * Update inline suggestions terminology * Reapply terminology update * Update terminology --------- Co-authored-by: Brigit Murtaugh <[email protected]> Co-authored-by: Nick Trogh <[email protected]>
1 parent df3df0d commit 3e31eb6

File tree

12 files changed

+70
-70
lines changed

12 files changed

+70
-70
lines changed

docs/copilot/ai-powered-suggestions.md

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
11
---
22
ContentId: 7ab2cd6c-45fd-4278-a6e8-1c9e060593ea
33
DateApproved: 10/09/2025
4-
MetaDescription: Enhance your coding with AI-powered code completions from GitHub Copilot in Visual Studio Code.
4+
MetaDescription: Enhance your coding with AI-powered inline suggestions from GitHub Copilot in Visual Studio Code.
55
MetaSocialImage: images/shared/github-copilot-social.png
66
Keywords: [nes, suggestions]
77
---
8-
# Code completions with GitHub Copilot in VS Code
8+
# Inline suggestions from GitHub Copilot in VS Code
99

10-
GitHub Copilot acts as an AI-powered pair programmer, automatically offering suggestions to complete your code, comments, tests, and more. It provides these suggestions directly in the editor while you write your code, and it can work with a broad range of programming languages and frameworks.
10+
GitHub Copilot acts as an AI-powered pair programmer, automatically offering inline suggestions to complete your code, comments, tests, and more. It provides these suggestions directly in the editor while you write your code, and it can work with a broad range of programming languages and frameworks.
1111

12-
Copilot provides two kinds of suggestions:
12+
You may experience two kinds of inline suggestions from Copilot, both of which match your coding style and take your existing code into account:
1313

14-
* **Code completions** - Start typing in the editor, and Copilot provides code suggestions that match your coding style and take your existing code into account.
14+
* **Ghost text suggestions** - Start typing in the editor, and Copilot provides dimmed *ghost text* suggestions at your current cursor location.
1515

1616
* **Next edit suggestions** - Predict your next code edit with Copilot next edit suggestions, aka Copilot NES. Based on the edits you're making, NES both predicts the location of the next edit you'll want to make and what that edit should be.
1717

@@ -24,21 +24,21 @@ Copilot provides two kinds of suggestions:
2424
1. Sign in with your GitHub account to use Copilot.
2525

2626
> [!TIP]
27-
> If you don't yet have a Copilot subscription, you can use Copilot for free by signing up for the [Copilot Free plan](https://github.com/github-copilot/signup) and get a monthly limit of completions and chat interactions.
27+
> If you don't yet have a Copilot subscription, you can use Copilot for free by signing up for the [Copilot Free plan](https://github.com/github-copilot/signup) and get a monthly limit of inline suggestions and chat interactions.
2828
2929
1. Discover the key features of Copilot in VS Code with our [Copilot Quickstart](/docs/copilot/getting-started.md).
3030

31-
## Inline suggestions
31+
## Getting your first suggestions
3232

33-
Copilot offers code suggestions as you type: sometimes the completion of the current line, sometimes a whole new block of code. You can accept all, or part of a suggestion, or you can keep typing and ignore the suggestions.
33+
Copilot offers dimmed *ghost text* suggestions as you type: sometimes the completion of the current line, sometimes a whole new block of code. You can accept all, or part of a suggestion, or you can keep typing and ignore the suggestions.
3434

3535
Notice in the following example how Copilot suggests an implementation of the `calculateDaysBetweenDates` JavaScript function by using dimmed *ghost text*:
3636

3737
![JavaScript ghost text suggestion.](images/inline-suggestions/js-suggest.png)
3838

3939
When you're presented with an inline suggestion, you can accept it with the `kbstyle(Tab)` key.
4040

41-
Copilot tries to apply the same coding style for the code suggestions that you already have in your code. Notice in the following example that Copilot applies the same input parameter naming scheme from the `add` method for the suggested `subtract` method.
41+
Copilot tries to apply the same coding style that you already have in your code. Notice in the following example that Copilot applies the same input parameter naming scheme from the `add` method for the suggested `subtract` method.
4242

4343
![JavaScript ghost text suggestion.](images/inline-suggestions/ts-suggest-parameter-names.png)
4444

@@ -62,7 +62,7 @@ The following example shows how to instruct Copilot to create a class in TypeScr
6262

6363
## Next edit suggestions
6464

65-
Inline suggestions are great at autocompleting a section of code. But since most coding activity is editing existing code, it's a natural evolution of Copilot code completions to also help with edits, both at the cursor and further away. Edits are often not made in isolation - there's a logical flow of what edits need to be made in different scenarios. Next edit suggestions (Copilot NES) is this evolution.
65+
Ghost text suggestions are great at autocompleting a section of code. But since most coding activity is editing existing code, it's a natural evolution of inline suggestions to also help with edits, both at the cursor and further away. Edits are often not made in isolation - there's a logical flow of what edits need to be made in different scenarios. Next edit suggestions (Copilot NES) is this evolution.
6666

6767
<video src="./images/inline-suggestions/nes-video.mp4" title="Video showing next edit suggestions in action on a Point typescript class." autoplay loop controls muted poster="./images/inline-suggestions/point3d.png"></video>
6868

@@ -117,23 +117,23 @@ By default, edit suggestions are indicated by the gutter arrow and the code chan
117117

118118
* **Matching code style**. After copy-pasting some code, Copilot will suggest how to adjust it to match the current code where the paste happened.
119119

120-
## Enable or disable code completions
120+
## Enable or disable inline suggestions
121121

122-
You can enable or disable code completions either for all languages or for specific languages only. To enable or disable code completions, select the Copilot menu in the Status Bar, and then check or uncheck the options to enable or disable code completions. The option to disable code completions for a specific language is dependent on the language of the active editor.
122+
You can enable or disable inline suggestions either for all languages or for specific languages only. To enable or disable inline suggestions, select the Copilot menu in the Status Bar, and then check or uncheck the options to enable or disable inline suggestions. The option to disable inline suggestions for a specific language is dependent on the language of the active editor.
123123

124124
![Screenshot of the Copilot menu in the Status Bar with Snooze and Cancel Snooze buttons.](images/inline-suggestions/snooze-code-completions.png)
125125

126-
Alternatively, modify the `setting(github.copilot.enable)` setting in the Settings editor. Add an entry for each language you want to enable or disable code completions for. To enable or disable code completions for all languages, set the value for `*` to `true` or `false`.
126+
Alternatively, modify the `setting(github.copilot.enable)` setting in the Settings editor. Add an entry for each language you want to enable or disable inline suggestions for. To enable or disable inline suggestions for all languages, set the value for `*` to `true` or `false`.
127127

128-
To temporarily disable all code completions in the editor, select the Copilot menu in the Status Bar, and then select the **Snooze** button to increment the snooze time by five minutes. To resume code completions, select the **Cancel Snooze** button in the Copilot menu.
128+
To temporarily disable all inline suggestions in the editor, select the Copilot menu in the Status Bar, and then select the **Snooze** button to increment the snooze time by five minutes. To resume inline suggestions, select the **Cancel Snooze** button in the Copilot menu.
129129

130130
Alternatively, use the **Snooze Inline Suggestions** and **Cancel Snooze Inline Suggestions** commands in the Command Palette.
131131

132-
## Change the AI model for completions
132+
## Change the AI model for suggestions
133133

134134
Different Large Language Models (LLMs) are trained on different types of data and might have different capabilities and strengths. Learn more about how to [choose between different AI language models](/docs/copilot/customization/language-models.md) in VS Code.
135135

136-
To change the language model that is used for generating code completions in the editor:
136+
To change the language model that is used for generating ghost text suggestions in the editor:
137137

138138
1. Open the Command Palette (`kbstyle(F1)`).
139139

@@ -142,7 +142,7 @@ To change the language model that is used for generating code completions in the
142142
1. In the dropdown menu, select the model you want to use.
143143

144144
> [!NOTE]
145-
> The list of available models might vary and change over time. The model picker may not always show more than one model, and preview models and additional code completion models will become available there if/when we release them. If you are a Copilot Business or Enterprise user, your Administrator needs to enable certain models for your organization by opting in to `Editor Preview Features` in the [Copilot policy settings](https://docs.github.com/en/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization) on GitHub.com.
145+
> The list of available models might vary and change over time. The model picker may not always show more than one model, and preview models and additional inline suggestion models will become available there if/when we release them. If you are a Copilot Business or Enterprise user, your Administrator needs to enable certain models for your organization by opting in to `Editor Preview Features` in the [Copilot policy settings](https://docs.github.com/en/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization) on GitHub.com.
146146
147147
## Tips & tricks
148148

@@ -152,7 +152,7 @@ To give you relevant inline suggestions, Copilot looks at the current and open f
152152

153153
## Settings
154154

155-
### Code completions settings
155+
### Ghost text suggestions settings
156156

157157
* `setting(github.copilot.enable)` - enable or disable inline completions for all or specific languages.
158158

docs/copilot/copilot-tips-and-tricks.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Depending on your task, you can choose between different Copilot tools.
3030

3131
| Tool | Use case |
3232
|------|----------|
33-
| [Code completions](/docs/copilot/ai-powered-suggestions.md) | Streamline coding while staying in the flow.<br/>Receive inline suggestions for code snippets, variable names, and functions as you write them in the editor. |
33+
| [Inline suggestions](/docs/copilot/ai-powered-suggestions.md) | Streamline coding while staying in the flow.<br/>Receive inline suggestions for code snippets, variable names, and functions as you write them in the editor. |
3434
| [Chat](/docs/copilot/chat/copilot-chat.md) | Have an ongoing chat conversation for brainstorming design ideas or getting code suggestions, optionally calling on domain-specific chat participants.<br/>Choose to apply specific code suggestions to your codebase. |
3535
| [Agent mode](/docs/copilot/chat/copilot-chat.md#built-in-chat-modes) | Implement high-level requirements by starting an agentic coding flow.<br/>Copilot autonomously invokes multiple tools to plan and implement the code changes and tasks that are needed. |
3636

docs/copilot/customization/custom-instructions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Custom instructions enable you to define common guidelines and rules that automa
1111
You can configure custom instructions to apply automatically to all chat requests or to specific files only. Alternatively, you can manually attach custom instructions to a specific chat prompt.
1212

1313
> [!NOTE]
14-
> Custom instructions are not taken into account for [code completions](/docs/copilot/ai-powered-suggestions.md) as you type in the editor.
14+
> Custom instructions are not taken into account for [inline suggestions](/docs/copilot/ai-powered-suggestions.md) as you type in the editor.
1515
1616
## Type of instructions files
1717

docs/copilot/customization/language-models.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ MetaSocialImage: ../images/shared/github-copilot-social.png
66
---
77
# AI language models in VS Code
88

9-
Visual Studio Code offers different built-in language models that are optimized for different tasks. You can also bring your own language model API key to use models from other providers. This article describes how to change the language model for chat or code completions, and how to use your own API key.
9+
Visual Studio Code offers different built-in language models that are optimized for different tasks. You can also bring your own language model API key to use models from other providers. This article describes how to change the language model for chat or inline suggestions, and how to use your own API key.
1010

1111
## Choose the right model for your task
1212

@@ -65,16 +65,16 @@ If you want to reduce the number of built-in models that are shown in the model
6565

6666
![Screenshot that shows the model Quick Pick to choose which models to show in the model picker.](../images/language-models/model-picker-choose-models.png)
6767

68-
## Change the model for code completions
68+
## Change the model for inline suggestions
6969

70-
To change the language model that is used for generating code completions in the editor:
70+
To change the language model that is used for generating inline suggestions in the editor:
7171

72-
1. Select **Configure Code Completions...** from the Chat menu in the VS Code title bar.
72+
1. Select **Configure Inline Suggestions...** from the Chat menu in the VS Code title bar.
7373

7474
1. Select **Change Completions Model...**, and then select one of the models from the list.
7575

7676
> [!NOTE]
77-
> The models that are available for code completions might evolve over time as we add support for more models.
77+
> The models that are available for inline suggestions might evolve over time as we add support for more models.
7878
7979
## Bring your own language model key
8080

@@ -159,7 +159,7 @@ Alternatively, you can manually add your custom model configuration in the `sett
159159

160160
There are a number of considerations when using your own language model API key in VS Code:
161161

162-
* Bringing your own model only applies to the chat experience and doesn't impact code completions or other AI-powered features in VS Code, such as commit-message generation.
162+
* Bringing your own model only applies to the chat experience and doesn't impact inline suggestions or other AI-powered features in VS Code, such as commit-message generation.
163163
* The capabilities of each model might differ from the built-in models and could affect the chat experience. For example, some models might not support vision or tool calling.
164164
* The Copilot API is still used for some tasks, such as sending embeddings, repository indexing, query refinement, intent detection, and side queries.
165165
* When using your own model, there is no guarantee that responsible AI filtering is applied to the model's output.
@@ -180,7 +180,7 @@ You can use locally hosted models in chat by using [bring your own model key](#b
180180
* Install an extension from the [Visual Studio Marketplace](https://marketplace.visualstudio.com/search?term=tag%3Alanguage-models&target=VSCode&category=All%20categories&sortBy=Relevance), for example, [AI Toolkit for VS Code with Foundry Local](https://aka.ms/AIToolkit)
181181
* Configure a [custom OpenAI-compatible model](#use-an-openai-compatible-model)
182182

183-
Currently, you cannot connect to a local model for code completions. VS Code provides an extension API [`InlineCompletionItemProvider`](/api/references/vscode-api.md#InlineCompletionItemProvider) that enables extensions to contribute a custom completion provider. You can get started with our [Inline Completions sample](https://github.com/microsoft/vscode-extension-samples/blob/main/inline-completions).
183+
Currently, you cannot connect to a local model for inline suggestions. VS Code provides an extension API [`InlineCompletionItemProvider`](/api/references/vscode-api.md#InlineCompletionItemProvider) that enables extensions to contribute a custom completion provider. You can get started with our [Inline Completions sample](https://github.com/microsoft/vscode-extension-samples/blob/main/inline-completions).
184184

185185
> [!NOTE]
186186
> Currently, using a locally hosted models still requires the Copilot service for some tasks. Therefore, your GitHub account needs to have access to a Copilot plan (for example, Copilot Free) and you need to be online. This requirement might change in a future release.

0 commit comments

Comments
 (0)