alt-text

Author: TylerMSFT

docs/embedded/serial-monitor.md

@@ -14,7 +14,9 @@ The Serial Monitor allows users to configure, monitor, and communicate with seri
 
 # [Visual Studio](#tab/visual-studio)
 
-![Serial Monitor in VS](media/serial-monitor.png)
+:::image type="complex" source="./media/serial-monitor.png" alt-text="Screenshot of the Visual Studio Serial Monitor window":::
+The window is split into two sections. The top section shows the monitoring mode (serial), Port (virtual COM port COM3), baud rate (115200), line ending (None), and a Stop monitoring button. The bottom section shows the messages, consisting of four lines of the text Hello, World!.
+:::image-end:::
 
 ## Capabilities
 
@@ -42,8 +44,13 @@ The Serial Monitor allows users to configure, monitor, and communicate with seri
 
 # [Visual Studio Code](#tab/visual-studio-code)
 
-![Serial Monitor in VSCode](media/serial-monitor-vscode.png)
-![Serial Monitor in VSCode - TCP](media/serial-monitor-vscode-tcp.png)
+:::image type="complex" source="./media/serial-monitor-vscode.png" alt-text="Screenshot of the VS Code Serial Monitor window.":::
+The window is split into two sections. The top section shows the monitoring mode (serial), Port (virtual COM port COM3), baud rate (115200), line ending (None), and a Stop monitoring button. The bottom section where messages are displayed is empty.
+:::image-end:::
+
+:::image type="complex" source="./media/serial-monitor-vscode-tcp.png" alt-text="Screenshot of the VS Code TCP Serial Monitor window.":::
+The window is split into two sections. The top section shows the monitoring mode (TCP), Host (::1), Port (1234), and a Start monitoring button. The bottom section shows the messages, starting with "Opening the TCP connection on ::1:1234. Then Connected to ::1:1234. Then five lines of the text Hello, World!. Then Closed the TCP connection ::1:1234.
+:::image-end:::
 
 ## Capabilities
 

docs/linux/download-install-and-setup-the-linux-development-workload.md

@@ -33,7 +33,7 @@ For any of these scenarios, the **Linux development with C++** workload is requi
 1. Look for the installer under the **Apps** results and double-click it. When the installer opens, choose **Modify**, and then click on the **Workloads** tab. Scroll down to **Other toolsets** and select the **Linux development with C++** workload.
 
    :::image type="complex" source="./media/linuxworkload.png" alt-text="Screenshot highlighting the Visual C++ for Linux Development workload item in Visual Studio Installer.":::
-   The Linux Development workload is selected. The Installation details pane is highlighted, which lists what's included in the workload, including Visual Studio C++ core features, Windows Universal C runtime, Visual C++ for Linux development. An optional component is also selected: Visual C++ tools for CMake and Linux.
+   The Linux Development workload is selected. The Installation details pane is highlighted, which lists what's included in the workload. Which includes: Visual Studio C++ core features, Windows Universal C runtime, Visual C++ for Linux development. An optional component is also selected: Visual C++ tools for CMake and Linux.
    :::image-end:::
 
 1. If you're targeting IoT or embedded platforms, go to the **Installation details** pane on the right. Under **Linux development with C++**, expand **Optional Components**, and choose the components you need. CMake support for Linux is selected by default.
@@ -101,7 +101,7 @@ The target Linux system must have **openssh-server**, **g++**, **gdb**, and **ma
    sudo apt-get install openssh-server g++ gdb make ninja-build rsync zip
    ```
 
-   You may be prompted for your root password to run the sudo command. If so, enter it and continue. Once complete, the required services and tools are installed.
+   You might be prompted for your root password to run the `sudo` command. If so, enter it and continue. Once complete, the required services and tools are installed.
 
 1. Ensure the ssh service is running on your Linux computer by running:
 
@@ -139,7 +139,7 @@ The target machine running Fedora uses the **dnf** package installer. To downloa
    sudo dnf install openssh-server gcc-g++ gdb ninja-build make rsync zip
    ```
 
-   You may be prompted for your root password to run the sudo command. If so, enter it and continue. Once complete, the required services and tools are installed.
+   You might be prompted for your root password to run the sudo command. If so, enter it and continue. Once complete, the required services and tools are installed.
 
 1. Ensure the ssh service is running on your Linux computer by running: