You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
12.[Essential Keyboard Navigation and Find/Filter](#12-essential-keyboard-navigation-and-findfilter)
@@ -203,7 +204,7 @@ Change the domain in any GitHub URL:
203
204
Everything in the list below works **exactly like desktop VS Code**:
204
205
205
206
-**Full text editor with syntax highlighting**
206
-
-**All VS Code keyboard shortcuts** (see [Keyboard Reference](13-github-copilot.md#8-keyboard-shortcuts-reference))
207
+
-**All VS Code keyboard shortcuts** (see [Section 11: Keyboard Shortcuts Editor](#11-the-keyboard-shortcuts-editor) and [Appendix M](appendix-m-vscode-accessibility-reference.md#5-complete-keyboard-shortcuts))
207
208
-**Screen reader mode** (`Shift+Alt+F1` to activate - Mac: `Shift+Option+F1`)
**Text description of the layout above:** VS Code has five major regions arranged in a grid. The **Menu Bar** spans the full width across the top. Below it, the **Activity Bar** runs vertically along the left edge (it contains icons for Explorer, Source Control, Search, Extensions, and more). The **Sidebar** appears to the right of the Activity Bar and shows content for the selected activity (file tree, search results, etc.). The **Editor Area** fills the large central region where your files open. Below the Editor Area, the **Panel** stretches across the bottom and contains the Terminal, Problems, Output, and Debug Console tabs. Finally, the **Status Bar** runs along the very bottom showing line number, column, language mode, Git branch, Copilot status, encoding, and notifications.
390
+
388
391
### Navigating Between Regions
389
392
390
393
| Region | Keyboard Shortcut | What You Hear (Screen Reader) |
@@ -748,6 +751,95 @@ If settings differ between machines, VS Code shows a merge editor where you choo
748
751
749
752
</details>
750
753
754
+
### Profiles
755
+
756
+
VS Code **Profiles** let you create named collections of settings, extensions, keyboard shortcuts, snippets, tasks, and UI state. Each profile is independent - switching profiles changes your entire VS Code configuration instantly. This is useful when you work in different contexts (workshop vs. daily development) or need to present with different display settings.
757
+
758
+
#### Creating a Profile
759
+
760
+
| Method | Steps |
761
+
| --- | --- |
762
+
| Command Palette |`Ctrl+Shift+P` then type `Profiles: Create Profile`|
763
+
| Gear menu | Click the gear icon (bottom-left of Activity Bar) then `Profiles` then `Create Profile`|
764
+
765
+
When creating a profile, you choose what to include:
You can start from the current configuration, an empty profile, or an existing profile template.
775
+
776
+
#### Switching Profiles
777
+
778
+
| Method | Steps |
779
+
| --- | --- |
780
+
| Command Palette |`Ctrl+Shift+P` then type `Profiles: Switch Profile`|
781
+
| Gear menu | Click the gear icon then `Profiles` then select a profile name |
782
+
| Status Bar | The current profile name appears in the Status Bar when you are not using the Default profile - click it to switch |
783
+
784
+
The active profile name appears in the VS Code title bar and Status Bar so you always know which configuration is active.
785
+
786
+
#### Workshop Profile Recommendations
787
+
788
+
Create these profiles before the workshop:
789
+
790
+
| Profile Name | Purpose | Key Settings |
791
+
| --- | --- | --- |
792
+
|**Workshop**| Accessibility-optimized for this event | Screen reader mode on, accessibility signals enabled, minimap off, word wrap on (see the [Recommended Workshop Profile](#recommended-workshop-profile) settings in Section 17) |
793
+
|**Presentation**| Large fonts for demos or shared screens |`editor.fontSize: 24`, `terminal.integrated.fontSize: 20`, `window.zoomLevel: 2`, High Contrast theme |
794
+
|**Default**| Your everyday development settings | Whatever you normally use |
795
+
796
+
#### Exporting and Sharing Profiles
797
+
798
+
Profiles can be exported and shared:
799
+
800
+
1.`Ctrl+Shift+P` then type `Profiles: Export Profile`
801
+
2. Choose what to include (settings, extensions, etc.)
802
+
3. Export as a **GitHub gist** (shareable link) or a **local file**
803
+
4. Share the link or file with others
804
+
805
+
To import: `Ctrl+Shift+P` then `Profiles: Import Profile` and paste the gist URL or select the file.
806
+
807
+
**Workshop tip:** Facilitators can export a pre-configured Workshop profile as a GitHub gist and share the link. Students import it in one step and immediately have all accessibility settings configured.
808
+
809
+
#### Profiles and Settings Sync
810
+
811
+
Profiles sync across machines through Settings Sync. When you create a profile on one machine and have Settings Sync enabled, the profile appears on every other machine where you are signed in. Each profile syncs independently - changes to one profile do not affect others.
812
+
813
+
#### Learning Cards: Profiles
814
+
815
+
<details>
816
+
<summary>Screen reader users</summary>
817
+
818
+
- The Command Palette is the fastest way to switch profiles: `Ctrl+Shift+P` then type `Switch Profile`
819
+
- Your screen reader announces the profile name when you switch - listen for the confirmation
820
+
- Create a **Workshop** profile with `editor.accessibilitySupport: "on"` and all your accessibility signals configured, so you can switch to it instantly at the start of each session
821
+
- The Default profile is always available as a fallback
822
+
823
+
</details>
824
+
825
+
<details>
826
+
<summary>Low vision users</summary>
827
+
828
+
- Create a **Presentation** profile with large fonts, high zoom, and a High Contrast theme for pair programming or demos
829
+
- Switching profiles changes everything at once - no need to adjust multiple settings individually
830
+
- The current profile name in the title bar confirms which configuration is active
831
+
832
+
</details>
833
+
834
+
<details>
835
+
<summary>Sighted users</summary>
836
+
837
+
- The gear icon in the Activity Bar (bottom-left) provides quick access to profile management
838
+
- Profile names appear in the title bar so you always know your current context
839
+
- Export your team's recommended profile as a GitHub gist for easy onboarding
840
+
841
+
</details>
842
+
751
843
752
844
---
753
845
@@ -1845,7 +1937,7 @@ On Linux, the extension requires the ALSA shared library (`libasound`). Install
1845
1937
1846
1938
## 19. Git Operations Inside VS Code
1847
1939
1848
-
This section previews the key Git operations you will perform inside VS Code. [Chapter 6 (Git & Source Control)](11-git-source-control.md) covers each in full detail with step-by-step walkthroughs. This is your orientation.
1940
+
This section previews the key Git operations you will perform inside VS Code. [Chapter 11 (Git & Source Control)](11-git-source-control.md) covers each in full detail with step-by-step walkthroughs. This is your orientation.
Copy file name to clipboardExpand all lines: docs/appendix-m-vscode-accessibility-reference.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -601,6 +601,8 @@ This prevents overlapping announcements.
601
601
602
602
## 7. Settings.json Configuration Examples
603
603
604
+
The configuration examples below are JSON blocks you paste into your `settings.json` file. To apply a complete set at once, consider using **VS Code Profiles** -- named configuration bundles that let you switch your entire setup instantly. See [Chapter 5, Section 9: Profiles](05-vscode-accessibility.md#profiles) for how to create, switch, export, and share profiles.
605
+
604
606
### Minimal Screen Reader Profile
605
607
606
608
#### For users who prefer minimal announcements and use Accessible View manually
0 commit comments