Skip to content

Commit 0fb4e8b

Browse files
authored
Merge pull request #4525 from TylerMSFT/alt-text2
alt-text updates
2 parents a4044f5 + 091483c commit 0fb4e8b

15 files changed

+143
-149
lines changed

docs/ide/cpp-linter-overview.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,9 @@ monikerRange: ">=msvc-160"
1616

1717
The IntelliSense code linter for C++ helps developers find and fix common C++ problems right inside Visual Studio. It's based on the same engine that provides C++ IntelliSense, so problems are flagged as soon as you type them.
1818

19-
![Animation showing the C plus plus linter in action.](../ide/media/linter-demo-animation.gif)
19+
:::image type="complex" source="media/linter-demo-animation.gif" alt-text="Animation showing the C plus plus linter in action.":::
20+
As the user types if (i = 3), a popup appears suggesting the correction i == 3, which is selected and updates the code to read if (i == 3)
21+
:::image-end:::
2022

2123
## Find problems
2224

@@ -26,7 +28,7 @@ Starting in Visual Studio 2022, the C++ Linter is enabled by default. To use it,
2628

2729
Most of the linter checks have suggestions for fixing the problem. Hover over the error squiggle and choose the light bulb that pops up to see the suggestions. A preview diff of the suggested change is shown, so you can confirm the change makes sense before you apply it.
2830

29-
## <a name="configure-the-linter"> Configure the linter
31+
## Configure the linter
3032

3133
You can enable or disable the linter, or configure the severity level for each check, in the C++ Code Style options.
3234

@@ -38,7 +40,7 @@ When you change the check severity level, it changes how the problem is shown in
3840

3941
::: moniker range=">=msvc-170"
4042

41-
![Screenshot that shows the C plus plus linter configuration.](../ide/media/linter-settings.png)
43+
![Screenshot of the linter configuration window with options such as warning on accidental assignment, uninitialized local variable, and more.](media/linter-settings.png)
4244

4345
(The presentation in Visual Studio 2019 is slightly different, but the options are similar.)
4446

docs/ide/how-to-set-preferences.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -16,15 +16,15 @@ You can make your C++ coding experience more convenient, productive, and pleasur
1616
- Specify C++ formatting rules, including several styles of ClangFormat.
1717
- Create custom keyboard shortcuts.
1818

19-
You can synchronize your preferences across multiple machines, and create and store multiple sets of preferences and share them with teammates. You can install extensions from the Visual Studio Marketplace, giving you additional options for customizing behavior. For more information, see [Personalize the Visual Studio IDE](/visualstudio/ide/personalizing-the-visual-studio-ide).
19+
You can synchronize your preferences across multiple machines, and create and store multiple sets of preferences and share them with teammates. You can install extensions from the Visual Studio Marketplace, giving you more options for customizing behavior. For more information, see [Personalize the Visual Studio IDE](/visualstudio/ide/personalizing-the-visual-studio-ide).
2020

2121
## Arrange window layout
2222

2323
Within the Visual Studio window, the space is divided into the main menu, the toolbar, the code editor (or document window), and tool windows (such as Solution Explorer and Error List). Some windows overlap each other in the same position. For example, Solution Explorer, Class View, Resource View, and Source Control Explorer all share the same default position. You switch among them by selecting the tabs at the bottom of the frame. To make two or more of these windows visible at the same time, just drag one of them by its title bar to a new position. You can dock it against one of the Visual Studio main window borders, or you can float it.
2424

2525
The following screenshot shows the **Team Explorer** window being dragged from its default position to a new, docked position on the left side of the code editor. The blue shaded area shows where the window will be placed when the mouse button is released.
2626

27-
![Screenshot of Visual Studio Team Explorer window, with layout change highlighted.](media/window-layout-move-team-explorer.png)
27+
![Screenshot of Visual Studio Team Explorer window, with the blue shaded area highlighted where the window will be placed when the mouse is released.](media/window-layout-move-team-explorer.png)
2828

2929
In the document window, each open file is contained in a tabbed frame. You can float or lock these tabs, just like tool windows. For more information, see [Customize window layouts in Visual Studio](/visualstudio/ide/customizing-window-layouts-in-visual-studio).
3030

@@ -34,33 +34,33 @@ To hide all the tool windows and maximize the Code Editor window, press **Alt**
3434

3535
You can specify many individual code formatting options, such as indentation and brace positions. To do so, go to **Tools** > **Options** > **Text Editor** > **C/C++** > **Formatting** (or type **Ctrl + Q** and search for "Formatting"). Alternatively, you can specify one of the [ClangFormat](https://clang.llvm.org/docs/ClangFormat.html) styles (or your own custom ClangFormat style).
3636

37-
![Screenshot of ClangFormat options.](media/clang-format-ide.png)
37+
![Screenshot of the Options pane with Text Editor > C / C plus plus > Formatting > General selected. In the right pane the ClangFormat options appear.](media/clang-format-ide.png)
3838

3939
For more information about all the formatting options, see [Options, Text Editor, C/C++, Formatting](/visualstudio/ide/reference/options-text-editor-c-cpp-formatting).
4040

4141
## Set the color theme
4242

4343
To set a light or dark background, type **Ctrl + Q** and search for "Color Theme". You can also find these by going to **Tools** > **Options** > **Environment**, and choosing **Color Theme**.
4444

45-
![Screenshot of color themes.](media/tools-options-color-theme.png)
45+
![Screenshot of the Options pane. Environment > General is selected. On the right, the color theme dropdown shows options for Light, Dark, and more.](media/tools-options-color-theme.png)
4646

4747
For example, here's the dark theme:
4848

49-
![Screenshot of Visual Studio with dark color theme.](media/tools-options-dark-theme.png)
49+
![Screenshot of Visual Studio with the dark color theme.](media/tools-options-dark-theme.png)
5050

5151
## Customize code colorization
5252

5353
In Visual Studio 2019, you can choose from three predefined *color schemes*. These specify how code elements are colorized in the editor. To choose a theme, go to **Tools** > **Options** > **Text Editor** > **C/C++** > **View**, and choose **Color Scheme**:
5454

55-
![Screenshot of C++ Color Scheme options, with Enhanced highlighted.](media/color-schemes.png)
55+
![Screenshot of C++ Color Scheme dropdown options. Of the available options, Enhanced is highlighted.](media/color-schemes.png)
5656

57-
In the color scheme called **Visual Studio 2017**, most code elements are simply black. In the **Enhanced** color scheme, functions, local variables, macros, and other elements are colorized. In the **Enhanced (Globals vs. Members)** scheme, global functions and variables are colorized to contrast with class members. The default mode is **Enhanced**, and it looks like this:
57+
In the color scheme called **Visual Studio 2017**, most code elements are black. In the **Enhanced** color scheme, functions, local variables, macros, and other elements are colorized. In the **Enhanced (Globals vs. Members)** scheme, global functions and variables are colorized to contrast with class members. The default mode is **Enhanced**, and it looks like this:
5858

59-
![Screenshot of enhanced color scheme.](media/color-scheme-enhanced.png)
59+
![Screenshot of the enhanced color scheme which has a black background and colors for C++ keywords such as blue for int and green for comments.](media/color-scheme-enhanced.png)
6060

6161
Regardless of which theme or color scheme is active, you can customize the font and colors for individual code elements. To do this, go to **Tools** > **Options** > **Environment** > **Fonts and Colors** (or type **Ctrl + Q** and search for "Fonts"). Scroll down the list of display items until you see the C++ options.
6262

63-
![Screenshot of C++ font and color options.](media/tools-options-cpp-colors.png)
63+
![Screenshot of C++ font and color options that shows you can set colors for C++ code elements such as enums, functions, keywords, macros, and so on.](media/tools-options-cpp-colors.png)
6464

6565
Colors that you set here override the values defined for the color schemes. If you want to go back to the default colors for the color scheme, set a color back to **Default**.
6666

@@ -70,19 +70,19 @@ The toolbars provide a convenient way to issue commands with a single click, rat
7070

7171
Hover over the icons in the toolbar to see which command it represents:
7272

73-
![Screenshot of toolbar icons, with example of command information available on hover.](media/toolbar-mouse-hover.png)
73+
![Screenshot of hovering over the bookmark icon. The tooltip says: "Toggle a bookmark on the current line", along with the keyboard shortcut Ctrl+K, Ctrl+K.](media/toolbar-mouse-hover.png)
7474

7575
You can add or remove commands, or create a custom toolbar, by selecting the down-arrow. To move the toolbar to a new location, drag it by the dotted bar on the left.
7676

77-
![Screenshot of toolbar, with down-arrow and dotted bar highlighted.](media/toolbar-move-edit.png).
77+
![Screenshot of a toolbar with the dotted bar on the left highlighted where you move the toolbar with the mouse. The down arrow is also highlighted.](media/toolbar-move-edit.png).
7878

7979
For more information, see [How to: Customize menus and toolbars in Visual Studio](/visualstudio/ide/how-to-customize-menus-and-toolbars-in-visual-studio).
8080

8181
## Show or hide line numbers
8282

8383
You can specify whether line numbers show on the left of the editor windows. In **Options**, under **C/C++**, select **General**. In the **Settings** section, select or clear **Line numbers**, depending on your preference.
8484

85-
![Screenshot of General options, with Line numbers highlighted.](media/tools-options-line-numbers.png)
85+
![Screenshot of General options (Text Editor > C / C plus plus > General). The Line numbers checkbox is highlighted.](media/tools-options-line-numbers.png)
8686

8787
## Create keyboard shortcuts
8888

docs/ide/live-share-cpp.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,13 +7,13 @@ ms.date: "05/24/2019"
77

88
In Visual Studio 2019 and Visual Studio Code, you can use **Live Share** to collaborate on C++ projects in real-time. With **Live Share** another person can edit and debug your code without having to install your project or any of its dependencies. You see each other's edits as they occur, and each edit is tagged with the name of the person who made it.
99

10-
![Screenshot of C plus plus Live Share Editing.](../ide/media/live-share-edit-cpp.png)
10+
![Screenshot of C plus plus Live Share Editing. A change to the code specifying a color is highlighted and annotated with the name of the person making it.](../ide/media/live-share-edit-cpp.png)
1111

1212
## Live Share host and guests
1313

14-
In a Live Share session there is a host and one or more guests. Both host and guests can use either Visual Studio or Visual Studio Code. A Visual Studio 2019 host on Windows can share with a Visual Studio Code guest on Linux.
14+
In a Live Share session, there's a host and one or more guests. Both host and guests can use either Visual Studio or Visual Studio Code. A Visual Studio 2019 host on Windows can share with a Visual Studio Code guest on Linux.
1515

16-
The host provides the guests with everything they need to be productive. Guests are not required to have the source code, compiler, external dependencies, or even the same installed components.
16+
The host provides the guests with everything they need to be productive. Guests aren't required to have the source code, compiler, external dependencies, or even the same installed components.
1717

1818
The host and guests can use these IntelliSense features:
1919

@@ -27,7 +27,7 @@ The host and guests can use these IntelliSense features:
2727
- Reference Highlighting
2828
- Diagnostics/Errors/Squiggles
2929

30-
![Screenshot of C plus plus Live Share Debugging.](../ide/media/live-share-debug-cpp.png)
30+
![A side-by-side screenshot of a C plus plus Live Share Debugging intended to show two people seeing the debugging experience on their own screen.](../ide/media/live-share-debug-cpp.png)
3131

3232
## Start and end a Live Share session
3333

0 commit comments

Comments
 (0)