Edit pass for house style

colin-home · colin-home · commit 1d8fc062116e · 2022-07-20T18:28:39.000-07:00
diff --git a/docs/embedded/download-and-install-the-embedded-tooling.md b/docs/embedded/download-and-install-the-embedded-tooling.md
@@ -12,46 +12,40 @@ monikerRange: '>=msvc-170'
 
 # [Visual Studio](#tab/visual-studio)
 
-## Download, install, and set up the Embedded workload
+In Visual Studio 2022 and later versions, you can use the Visual Studio IDE on Windows to edit and debug embedded projects. Use tools such as the [Peripheral Viewer](./peripheral-view.md), [RTOS Viewer](./rtos-view.md), and the [Serial Monitor](./serial-monitor.md) to help interact with and debug your embedded projects.
 
-Embedded tooling is supported in Visual Studio 2022 and later. To see the documentation for these versions, set the Visual Studio **Version** selector control for this article to Visual Studio 2022. It's found at the top of the table of contents on this page.
+To use the embedded development tools in Visual Studio, you must install the required **Linux and embedded development with C++** workload.
 
-You can use the Visual Studio IDE on Windows to edit and debug Embedded projects.
+## To install the Linux and embedded development with C++ workload
 
-You can use tools like the [Peripheral Viewer](./peripheral-view.md), [RTOS Viewer](./rtos-view.md), and the [Serial Monitor](./serial-monitor.md) to help interact with and debug your embedded projects.
-
-For any of these scenarios, the **Linux and embedded development with C++** workload is required.
-
-## Visual Studio setup
-
-1. Type "Visual Studio Installer" in the Windows search box:
+1. Enter "Visual Studio Installer" in the Windows search box:
 
    ![Screenshot showing the Windows search box.](../linux/media/visual-studio-installer-search.png)
 
-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 and embedded development with C++** workload.
+1. Open the Visual Studio Installer. In Visual Studio Installer, choose **Modify** next to your installation of Visual Studio, and then select the **Workloads** tab. Scroll down to **Other toolsets** and select the **Linux and embedded development with C++** workload.
 
    ![Screenshot showing the Visual C++ for Linux Development workload item in Visual Studio Installer.](media/linux-and-embedded-workload.png)
 
-1. Click **Modify** to continue with the installation.
+1. Choose **Modify** to continue with the installation.
+
+When installation completes, you're ready to use Visual Studio for embedded development.
 
 # [Visual Studio Code](#tab/visual-studio-code)
 
-## Install the Embedded extensions in VSCode
+## Install the Embedded extensions in Visual Studio Code
 
-Embedded tools like a [Peripheral Viewer](./peripheral-view.md), [RTOS Viewer](./rtos-view.md), and a [Serial Monitor](./serial-monitor.md) are supported in VSCode. This means that you now can use Microsoft tools to help debug your embedded applications in VSCode.
+Microsoft provides an extension to Visual Studio Code that lets you use embedded tools such as a [Peripheral Viewer](./peripheral-view.md), [RTOS Viewer](./rtos-view.md), and a [Serial Monitor](./serial-monitor.md). Now you can use Microsoft tools to help debug your Linux-based embedded applications.
 
-## Visual Studio Code setup
+## To install the embedded extensions for Visual Studio Code
 
-1. Type Visual Studio Code in the Windows search box:
+1. Enter "Visual Studio Code" in the Windows search box:
 
     ![Search-Visual-Studio-Code](media/windows-search-vscode.png)
 
-1. Look for Visual Studio Code under **Apps** and double-click it. When Visual Studio Code opens, open the **Extensions Pane**.
+1. Open Visual Studio Code. In Visual Studio Code, open the **Extensions Pane**.
 
     ![Visual Studio Code Extensions Pane](media/extensions-pane.png)
 
-### Install the Embedded Tools extension
-
 1. Search for and install the [Embedded Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-embedded-tools) extension.
 
     ![Embedded Tools extension](media/embedded-tools-extension.png)
@@ -60,4 +54,6 @@ Embedded tools like a [Peripheral Viewer](./peripheral-view.md), [RTOS Viewer](.
 
     ![Serial Monitor extension](media/serial-monitor-extension.png)
 
+When installation completes, you're ready to use Visual Studio Code for embedded development.
+
 ---
diff --git a/docs/embedded/peripheral-view.md b/docs/embedded/peripheral-view.md
@@ -10,23 +10,23 @@ monikerRange: '>=msvc-170'
 
 ## Overview
 
-The Peripheral View allows embedded developers to view and manipulate registers and peripherals defined SVD (System View Description) files.
+The Peripheral View allows embedded developers to view and manipulate registers and peripherals defined in SVD (System View Description) files.
 
 # [Visual Studio](#tab/visual-studio)
 
 ![Peripheral View in VS](media/peripheral-viewer.png)
 
 # [Visual Studio Code](#tab/visual-studio-code)
 
-![Peripheral View in VSCode](media/peripheral-viewer-vscode.png)
+![Peripheral View in Visual Studio Code](media/peripheral-viewer-vscode.png)
 
 ---
 
 ## Capabilities
 
-|Capabilities|Description|Instructions|Keyboard shortcuts|
+| Capability | Description | Instructions | Keyboard shortcuts |
 |:-:|:-:|:-:|:-:|
-|Navigation|Navigate the peripheral tree view by collapsing and expanding components in the tree view|Scroll to view all of the peripherals. Press the caret on each item to expand or collapses|Arrow-Up/Arrow-Down to scroll. Arrow-Left/Arrow-Right to expand/collapse.
-|Editing|Modify writeable peripheral values|Double click on the peripheral value to edit and press Enter to submit that value|F2 to edit. Esc to cancel editing. Enter to submit edits.|
-|Accessing memory|View the memory locations of peripherals|Click on the linked memory addresses|Tab to the link, Enter to navigate to the link.|
-|Pinning|Pin important peripherals to the top of the view|Click the pin icon to pin or unpin peripherals|Tab to the pin icon, Enter to pin/unpin|
+| Navigate peripherals | Navigate the peripheral tree view by collapsing and expanding components in the tree view. | Scroll to view all of the peripherals. Select the caret on each item to expand or collapse the view. | Use the **Up** or **Down** arrow keys to scroll. Use the **Left** and **Right** arrow keys to expand or collapse the view. |
+| Edit peripheral values | Modify writeable peripheral values. | Select the peripheral value to edit. Use the **Enter** key to submit that value. | Use the **F2** key to edit, **Esc** to cancel editing, and **Enter** to submit edits. |
+| Access memory | View the memory locations of peripherals. | Select the linked memory addresses to view. | Use **Tab** to select the link, and **Enter** to navigate to the link. |
+| Pin peripherals | Pin important peripherals to the top of the view. | Select the pin icon to pin or unpin peripherals. | Use **Tab** to select the pin icon, and **Enter** to pin or unpin it. ||
diff --git a/docs/embedded/rtos-view.md b/docs/embedded/rtos-view.md
@@ -10,7 +10,7 @@ monikerRange: '>=msvc-170'
 
 ## Overview
 
-The RTOS Object Views allow for users to view various components of an RTOS while debugging their application.
+The RTOS Object View allows users to view various components of an RTOS while debugging their application.
 
 # [Visual Studio](#tab/visual-studio)
 
@@ -25,14 +25,14 @@ The RTOS Object Views allow for users to view various components of an RTOS whil
 ## Supported RTOSes and their supported object types
 
 - ThreadX
-  - All of the **Available Object Types** list
+  - All of the types listed in **Available object types**
 - FreeRTOS
   - Threads
   - Queues
 - Zephyr
-  - All of the **Available Object Types** list
+  - All of the types listed in **Available object types**
 
-## Available Object Types
+### Available object types
 
 - Block Pools
 - Byte Pools
@@ -45,10 +45,9 @@ The RTOS Object Views allow for users to view various components of an RTOS whil
 
 ## Usage
 
-- Access memory locations of various objects
-- Access thread variables or various objects in the Watch view
+Use the RTOS Object View to:
 
-## Accessibility
+- Access memory locations of various objects.
+- Access thread variables or various objects in the Watch view.
 
-- Use the Arrow Keys to navigate the view
-- Press Enter to navigate to linked content
+Use the arrow keys to select objects within the view. Use the **Enter** key to navigate to the linked content.
diff --git a/docs/embedded/serial-monitor.md b/docs/embedded/serial-monitor.md
@@ -1,7 +1,7 @@
 ---
 title: "Serial Monitor"
 ms.date: "07/12/2022"
-description: "Serial Monitor tool that allows user to monitor, and communicate with serial ports."
+description: "Serial Monitor allows users to configure, monitor, and communicate with serial ports."
 author: gcampbell-msft
 ms.author: gcampbell
 monikerRange: '>=msvc-170'
@@ -24,17 +24,17 @@ The Serial Monitor allows users to configure, monitor, and communicate with seri
 
 ## Capabilities
 
-- `Monitor a serial port`: Press the "Start Monitoring" or "Stop Monitoring button to begin monitoring data coming from the port.
-- `Send data to a serial port`: Input text into the text field at the bottom of the view. Press Enter or the "Send Message" button to send the data.
-- `Clear the Serial Monitor output`: Press the clear output button to clear the incoming data text field.
-- `Configure Serial Monitor and port connection settings`: See the following table to learn about the settings that the Serial Monitor provides.
+- **Monitor a serial port**: Choose the **Start Monitoring** or **Stop Monitoring** button to control whether to monitor data coming from the port.
+- **Send data to a serial port**: Enter text into the text field at the bottom of the view. Use the **Enter** key or choose the **Send Message** button to send the data.
+- **Clear the Serial Monitor output**: Choose the **Clear Output** button to clear the incoming data text field.
+- **Configure Serial Monitor and port connection settings**: See the following table to learn about the settings that the Serial Monitor provides.
 
 ## Configurable settings
 
-|Settings|Description|Usage|Available options|
-|:------:|:---------:|:-:|:-:|
-|Port|Ports that are actively connected to a device|Use the `Port` dropdown|Serial port compatible devices connected to the machine|
-|Baud Rate|Frequency at which the monitor will attempt to communicate with the connected device|Use the `Baud Rate` dropdown|300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 74880, 115200, 230000, 250000|
-|Line ending|Appended line ending on messages sent to the connected device|Use the `Line Ending` dropdown|None, LF, CR, CRLF|
-|Timestamp|Ability to add timestamps to the output of data received from the connected port|Use the `timestamp` toggle button|On/Off|
-|Auto-scrolling|Ability to "auto-scroll" with new content coming from the connected port|Use the `auto-scroll` toggle button|On/Off|
+| Settings | Description | Usage | Available options |
+|--|--|--|--|
+| **Port** | Ports that are actively connected to a device | Use the **Port** dropdown | Serial port compatible devices connected to the machine |
+| **Baud Rate** | Frequency at which the monitor attempts to communicate with the connected device | Use the **Baud Rate** dropdown | 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 74880, 115200, 230000, 250000 |
+| **Line ending** | The line ending to use in messages sent to the connected device | Use the **Line Ending** dropdown | None, LF, CR, CRLF |
+| **Timestamp** | Adds timestamps to the output of data received from the connected port | Use the **timestamp** toggle button | On/Off |
+| **Auto-scroll** | Whether to auto-scroll new content that comes from the connected port | Use the **auto-scroll** toggle button | On/Off |
