Skip to content

Commit 9034aa6

Browse files
authored
Merge pull request #7959 from microsoft/terminology-keybinding
Align keyboard shortcuts terminology
2 parents b79e369 + 90c4efb commit 9034aa6

25 files changed

+127
-127
lines changed

docs/copilot/copilot-settings.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ The team is continuously working on improving Copilot in VS Code and adding new
5252

5353
* `setting(inlineChat.acceptedOrDiscardBeforeSave)`: Controls whether pending Inline Chat sessions in an editor prevent saving the file.
5454
* `setting(inlineChat.finishOnType)`: Whether to finish an Inline Chat session when typing outside of changed regions.
55-
* `setting(inlineChat.holdToSpeech)`: Whether holding the Inline Chat keybinding will automatically enable speech recognition.
55+
* `setting(inlineChat.holdToSpeech)`: Whether holding the Inline Chat keyboard shortcut will automatically enable speech recognition.
5656
* `setting(inlineChat.inlineChat.lineEmptyHint)` <i class="codicon codicon-beaker"></i>: Controls whether to show a hint for Inline Chat on an empty line.
5757
* `setting(inlineChat.mode)`: Configure if changes crafted with Inline Chat are applied directly to the document or are previewed first.
5858
* `setting(inlineChat.lineNaturalLanguageHint)` <i class="codicon codicon-beaker"></i>: Experimental suggestion that triggers Inline Chat as soon as a line mostly consists of words.

docs/copilot/getting-started.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ To get started with GitHub Copilot in VS Code, you don't have to do anything spe
5858
5959
![Screenshot of VS Code editor, showing Copilot giving multiple suggestions for `factorial` when hovering over it.](./images/getting-started/copilot-code-completion-multiple.png)
6060
61-
You can use the arrow controls or use the keybindings to show the next (`kb(editor.action.inlineSuggest.showNext)`) or previous (`kb(editor.action.inlineSuggest.showPrevious)`) suggestion.
61+
You can use the arrow controls or use the keyboard shortcuts to show the next (`kb(editor.action.inlineSuggest.showNext)`) or previous (`kb(editor.action.inlineSuggest.showPrevious)`) suggestion.
6262
6363
AI-powered code completions can help you with generating boilerplate or repetitive code, letting you stay in the developer flow and focus on more complex coding tasks.
6464

docs/editor/accessibility.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -118,7 +118,7 @@ VS Code also has many preset keyboard shortcuts for commands.
118118

119119
![Key bindings for commands are displayed at the end of the command palette entry](images/accessibility/keyboard-shortcuts.png)
120120

121-
You can also set your own keyboard shortcuts. **File** > **Preferences** > **Keyboard Shortcuts** (`kb(workbench.action.openGlobalKeybindings)`) opens the Keyboard Shortcuts editor, where you can discover and modify key bindings for VS Code actions. See [Key Bindings](/docs/getstarted/keybindings.md) for more details on customizing or adding your own keyboard shortcuts.
121+
You can also set your own keyboard shortcuts. **File** > **Preferences** > **Keyboard Shortcuts** (`kb(workbench.action.openGlobalKeybindings)`) opens the Keyboard Shortcuts editor, where you can discover and modify keyboard shortcuts for VS Code actions. See [Key Bindings](/docs/getstarted/keybindings.md) for more details on customizing or adding your own keyboard shortcuts.
122122

123123
For quick navigation across the workbench, we recommend using **Focus Next Part** (`kb(workbench.action.focusNextPart)`) and **Focus Previous Part** (`kb(workbench.action.focusPreviousPart)`) commands.
124124

docs/editor/codebasics.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,7 @@ Place the cursor in one corner and then hold `kbstyle(Shift+Alt)` while dragging
6666
> [!NOTE]
6767
> This changes to `kbstyle(Shift+Ctrl/Cmd)` when using `kbstyle(Ctrl/Cmd)` as [multi-cursor modifier](#multi-cursor-modifier).
6868
69-
There are also default key bindings for column selection on macOS and Windows, but not on Linux.
69+
There are also default keyboard shortcuts for column selection on macOS and Windows, but not on Linux.
7070

7171
Key|Command|Command ID
7272
---|-------|----------
@@ -251,12 +251,12 @@ The Search Editor above was opened by selecting the **Open New Search Editor** b
251251
* `search.action.openInEditor` - Copy the current Search results into a new Search Editor.
252252
* `search.action.openNewEditorToSide` - Opens the Search Editor in a new window next to the window you currently have opened.
253253

254-
There are two arguments that you can pass to the Search Editor commands (`search.action.openNewEditor`, `search.action.openNewEditorToSide`) to allow keybindings to configure how a new Search Editor should behave:
254+
There are two arguments that you can pass to the Search Editor commands (`search.action.openNewEditor`, `search.action.openNewEditorToSide`) to allow keyboard shortcuts to configure how a new Search Editor should behave:
255255

256256
* `triggerSearch` - Whether a search be automatically run when a Search Editor is opened. Default is true.
257257
* `focusResults` - Whether to put focus in the results of a search or the query input. Default is true.
258258

259-
For example, the following keybinding runs the search when the Search Editor is opened but leaves the focus in the search query control.
259+
For example, the following keyboard shortcut runs the search when the Search Editor is opened but leaves the focus in the search query control.
260260

261261
```json
262262
{
@@ -276,7 +276,7 @@ The `setting(search.searchEditor.reusePriorSearchConfiguration)` setting (defaul
276276

277277
## IntelliSense
278278

279-
We'll always offer word completion, but for the rich [languages](/docs/languages/overview.md), such as JavaScript, JSON, HTML, CSS, SCSS, Less, C# and TypeScript, we offer a true IntelliSense experience. If a language service knows possible completions, the IntelliSense suggestions will pop up as you type. You can always manually trigger it with `kb(editor.action.triggerSuggest)`. By default, `kbstyle(Tab)` or `kbstyle(Enter)` are the accept keyboard triggers but you can also [customize these key bindings](/docs/getstarted/keybindings.md).
279+
We'll always offer word completion, but for the rich [languages](/docs/languages/overview.md), such as JavaScript, JSON, HTML, CSS, SCSS, Less, C# and TypeScript, we offer a true IntelliSense experience. If a language service knows possible completions, the IntelliSense suggestions will pop up as you type. You can always manually trigger it with `kb(editor.action.triggerSuggest)`. By default, `kbstyle(Tab)` or `kbstyle(Enter)` are the accept keyboard triggers but you can also [customize these keyboard shortcuts](/docs/getstarted/keybindings.md).
280280

281281
> [!TIP]
282282
> The suggestions filtering supports CamelCase, so you can type the letters which are upper cased in a method name to limit the suggestions. For example, "cra" will quickly bring up "createApplication".
@@ -484,7 +484,7 @@ As in other editors, commands such as **Cut** and **Copy** apply to the whole wr
484484

485485
### How can I avoid placing extra cursors in word wrapped lines?
486486

487-
If you'd like to ignore line wraps when adding cursors above or below your current selection, you can pass in `{ "logicalLine": true }` to `args` on the keybinding like this:
487+
If you'd like to ignore line wraps when adding cursors above or below your current selection, you can pass in `{ "logicalLine": true }` to `args` on the keyboard shortcut like this:
488488

489489
```json
490490
{

docs/editor/editingevolved.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ Visual Studio Code has a high productivity code editor which, when combined with
1515

1616
>**Tip:** You can open any file by its name when you type `kb(workbench.action.quickOpen)` (**Quick Open**).
1717
18-
The Explorer is great for navigating between files when you are exploring a project. However, when you are working on a task, you will find yourself quickly jumping between the same set of files. VS Code provides two powerful commands to navigate in and across files with easy-to-use key bindings.
18+
The Explorer is great for navigating between files when you are exploring a project. However, when you are working on a task, you will find yourself quickly jumping between the same set of files. VS Code provides two powerful commands to navigate in and across files with easy-to-use keyboard shortcuts.
1919

2020
Hold `kbstyle(Ctrl)` and press `kbstyle(Tab)` to view a list of all files open in an editor group. To open one of these files, use `kbstyle(Tab)` again to pick the file you want to navigate to, then release `kbstyle(Ctrl)` to open it.
2121

@@ -197,14 +197,14 @@ Now that you know how the editor works, time to try a few other things...
197197

198198
* [Intro Video - Code Editing](/docs/introvideos/codeediting.md) - Watch an introductory video on code editing features.
199199
* [User Interface](/docs/getstarted/userinterface.md) - In case you missed a basic orientation around VS Code.
200-
* [Key Bindings](/docs/getstarted/keybindings.md) - Learn how to modify key bindings to your preference.
200+
* [Key Bindings](/docs/getstarted/keybindings.md) - Learn how to modify keyboard shortcuts to your preference.
201201
* [Debugging](/docs/editor/debugging.md) - This is where VS Code really shines.
202202

203203
## Common questions
204204

205205
### How can I automatically select the second entry in Quick Open instead of the first?
206206

207-
With the command `workbench.action.quickOpenPreviousEditor`, you can have the second entry automatically selected in Quick Open. This can be useful if you want to select the previous entry from the list without having to invoke another keybinding:
207+
With the command `workbench.action.quickOpenPreviousEditor`, you can have the second entry automatically selected in Quick Open. This can be useful if you want to select the previous entry from the list without having to invoke another keyboard shortcut:
208208

209209
```json
210210
[

docs/editor/extension-marketplace.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -385,7 +385,7 @@ It's recommended that you contact the [Visual Studio Marketplace team](mailto:vs
385385

386386
### My extensions don't synchronize when connected to a remote window
387387

388-
[Settings Sync](/docs/editor/settings-sync.md) lets you share your Visual Studio Code configurations such as settings, keybindings, and installed extensions across your machines so you are always working with your favorite setup.
388+
[Settings Sync](/docs/editor/settings-sync.md) lets you share your Visual Studio Code configurations such as settings, keyboard shortcuts, and installed extensions across your machines so you are always working with your favorite setup.
389389

390390
VS Code does not synchronize your extensions to or from a [remote](/docs/remote/remote-overview.md) window, such as when you're connected to SSH, a development container (devcontainer), or WSL.
391391

docs/editor/intellisense.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,7 @@ VS Code IntelliSense offers different types of completions, including language s
7777

7878
## Customizing IntelliSense
7979

80-
You can customize your IntelliSense experience in settings and key bindings.
80+
You can customize your IntelliSense experience in settings and keyboard shortcuts.
8181

8282
### Settings
8383

@@ -161,11 +161,11 @@ When using the last option, `recentlyUsedByPrefix`, VS Code remembers which item
161161

162162
By default, VS Code shows snippets and completion proposals in one widget. You can control the behavior with the `setting(editor.snippetSuggestions)` setting. To remove snippets from the suggestions widget, set the value to `"none"`. If you'd like to see snippets, you can specify the order relative to suggestions; at the top (`"top"`), at the bottom (`"bottom"`), or inline ordered alphabetically (`"inline"`). The default is `"inline"`.
163163

164-
### Key bindings
164+
### Keyboard shortcuts
165165

166-
The key bindings shown below are the default key bindings. You can change these in your `keybindings.json` file as described in [Key Bindings](/docs/getstarted/keybindings.md).
166+
The keyboard shortcuts shown below are the default keyboard shortcuts. You can change these in your `keybindings.json` file as described in [Key Bindings](/docs/getstarted/keybindings.md).
167167

168-
> **Note:** There are many more key bindings relating to IntelliSense. Open the **Default Keyboard Shortcuts** (**File** > **Preferences** > **Keyboard Shortcuts**) and search for "suggest".
168+
> **Note:** There are many more keyboard shortcuts relating to IntelliSense. Open the **Default Keyboard Shortcuts** (**File** > **Preferences** > **Keyboard Shortcuts**) and search for "suggest".
169169
170170
```json
171171
[

docs/editor/profiles.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -409,7 +409,7 @@ If the profile specified does not exist, a new empty profile with the given name
409409

410410
### Where are profiles kept?
411411

412-
Profiles are stored under your User configurations similar to your user settings and keybindings.
412+
Profiles are stored under your User configurations similar to your user settings and keyboard shortcuts.
413413

414414
* **Windows** `%APPDATA%\Code\User\profiles`
415415
* **macOS** `$HOME/Library/Application\ Support/Code/User/profiles`

docs/editor/refactoring.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -92,9 +92,9 @@ Optionally, you can partially apply the refactoring changes by deselecting some
9292

9393
![Screenshot of the Refactor Preview panel that shows how to partially apply changes by deselecting specific changes.](images/refactoring/refactor-preview-partial.png)
9494

95-
## Keybindings for Code Actions
95+
## Keyboard shortcuts for Code Actions
9696

97-
The `editor.action.codeAction` command lets you configure keybindings for specific Code Actions. This keybinding, for example, triggers the **Extract function** refactoring Code Actions:
97+
The `editor.action.codeAction` command lets you configure keyboard shortcuts for specific Code Actions. This keyboard shortcut, for example, triggers the **Extract function** refactoring Code Actions:
9898

9999
```json
100100
{
@@ -108,7 +108,7 @@ The `editor.action.codeAction` command lets you configure keybindings for specif
108108

109109
Code Action kinds are specified by extensions using the enhanced `CodeActionProvider` API. Kinds are hierarchical, so `"kind": "refactor"` shows all refactoring Code Actions, whereas `"kind": "refactor.extract.function"` only shows **Extract function** refactorings.
110110

111-
Using the above keybinding, if only a single `"refactor.extract.function"` Code Action is available, it is automatically applied. If multiple **Extract function** Code Actions are available, VS Code brings up a context menu to select them:
111+
Using the above keyboard shortcut, if only a single `"refactor.extract.function"` Code Action is available, it is automatically applied. If multiple **Extract function** Code Actions are available, VS Code brings up a context menu to select them:
112112

113113
![Select Code Action context menu](images/refactoring/code-action-context-menu.png)
114114

@@ -131,9 +131,9 @@ Valid values for `apply`:
131131
* `ifSingle` - (Default) Automatically apply the Code Action if only one is available. Otherwise, show the context menu.
132132
* `never` - Always show the Code Action context menu, even if only a single Code Action is available.
133133

134-
When a Code Action keybinding is configured with `"preferred": true`, only preferred Quick Fixes and refactorings are shown. A preferred Quick Fix addresses the underlying error, while a preferred refactoring is the most common refactoring choice. For example, while multiple `refactor.extract.constant` refactorings might exist, each extracting to a different scope in the file, the preferred `refactor.extract.constant` refactoring is the one that extracts to a local variable.
134+
When a Code Action keyboard shortcut is configured with `"preferred": true`, only preferred Quick Fixes and refactorings are shown. A preferred Quick Fix addresses the underlying error, while a preferred refactoring is the most common refactoring choice. For example, while multiple `refactor.extract.constant` refactorings might exist, each extracting to a different scope in the file, the preferred `refactor.extract.constant` refactoring is the one that extracts to a local variable.
135135

136-
This keybinding uses `"preferred": true` to create a refactoring that always tries to extract the selected source code to a constant in the local scope:
136+
This keyboard shortcut uses `"preferred": true` to create a refactoring that always tries to extract the selected source code to a constant in the local scope:
137137

138138
```json
139139
{

docs/editor/settings-sync.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ MetaDescription: Synchronize your user settings across all your Visual Studio Co
99
---
1010
# Settings Sync
1111

12-
Settings Sync lets you share your Visual Studio Code configurations such as settings, keybindings, and installed extensions across your machines so you are always working with your favorite setup.
12+
Settings Sync lets you share your Visual Studio Code configurations such as settings, keyboard shortcuts, and installed extensions across your machines so you are always working with your favorite setup.
1313

1414
> **Note**: VS Code does not synchronize your extensions to or from a [remote](/docs/remote/remote-overview.md) window, such as when you're connected to SSH, a development container (devcontainer), or WSL.
1515

0 commit comments

Comments
 (0)