Fix broken links (and standardize keys) (#2926)

Author: gewarren

docs/android/emulator/index.md

@@ -44,22 +44,22 @@ Common actions can be performed in the emulator via its panel on the right hand
 
 The following gestures can be simulated in the emulator:
 
-| Gesture | Description |
-| ------- | ----------- |
-| Tap | Press and release the primary mouse button. |
-| Double tap | Double-click and then release the primary mouse button. |
-| Drag | Press and hold the primary mouse button, move the item, and then release. |
-| Touch and hold | Press the primary mouse button, hold, and release. |
-| Pinch | Press the CTRL key on Windows, or the Command key on macOS, to display a pinch gesture multi-touch interface. The mouse acts as the first finger, which can be moved by dragging the cursor. The second finger is across from the anchor point. Pressing the left mouse button simulates touching both points, and releasing simulates removing both points. |
-| Swipe | Press and hold the primary mouse button, swipe, and then release. |
+| Gesture        | Description                                                               |
+|----------------|---------------------------------------------------------------------------|
+| Tap            | Press and release the primary mouse button.                               |
+| Double tap     | Double-click and then release the primary mouse button.                   |
+| Drag           | Press and hold the primary mouse button, move the item, and then release. |
+| Touch and hold | Press the primary mouse button, hold, and release.                        |
+| Pinch          | Press the Ctrl key on Windows or the Command key on macOS to display a pinch gesture multi-touch interface. The mouse acts as the first finger, which can be moved by dragging the cursor. The second finger is across from the anchor point. Pressing the left mouse button simulates touching both points, and releasing simulates removing both points. |
+| Swipe          | Press and hold the primary mouse button, swipe, and then release. |
 | Vertical swipe | Open a vertical menu on the screen and use the mouse scroll wheel to scroll through the menu items. |
 
 ## Advanced emulator scenarios
 
 You might want to test your app on a virtual device using more than just basic touch gestures. For example, you might want to simulate different network conditions. The following table lists where to find more information about advanced Android emulator scenarios:
 
-| Scenarios | More information |
-| ------- | ---------------- |
+| Scenarios      | More information |
+|----------------|------------------|
 | Use the camera | [Camera support](https://developer.android.com/studio/run/emulator-use-camera) on developer.android.com |
 | Install and add files | [Install and add files](https://developer.android.com/studio/run/emulator-install-add-files) on developer.android.com |
 | Use Wi-Fi | [Wi-Fi](https://developer.android.com/studio/run/emulator-wifi) on developer.android.com |

docs/android/emulator/mac-with-windows-vm.md

@@ -51,7 +51,7 @@ To connect to the Android Emulator running on a Mac from a Windows VM, by using
 
     In this example, `127.0.0.1 5555` denotes the odd-numbered port on the loopback interface.
 
-    Provided that the `nc` command keeps running in a Terminal window, packets will be forwarded as expected. Once you've finished using the emulator, you can stop `nc` performing packet forwarding by pressing <kbd>CTRL+C</kbd> in the Terminal window.
+    Provided that the `nc` command keeps running in a Terminal window, packets will be forwarded as expected. Once you've finished using the emulator, you can stop `nc` performing packet forwarding by pressing <kbd>Ctrl+C</kbd> in the Terminal window.
 
 1. In your Windows VM, open **Command Prompt**.
 1. In **Command Prompt**, connect to the emulator:
@@ -63,7 +63,7 @@ To connect to the Android Emulator running on a Mac from a Windows VM, by using
     Replace `ip-address-of-the-mac` in this example with the IP address of your Mac, and 5555 with the port you've used from the previous step.
 
     > [!NOTE]
-    > Command line access to `adb` can be obtained in Visual Studio through the **Tools > Android > Android Adb Command Prompt...** menu item.  
+    > Command line access to `adb` can be obtained in Visual Studio through the **Tools > Android > Android Adb Command Prompt...** menu item.
 
 When the connection is completed Visual Studio will display the emulator as a debug target under **Android Local Devices**, which you can use to deploy your app to the emulator.
 
@@ -115,6 +115,6 @@ To connect to the Android Emulator running on a Mac from a Windows virtual machi
     In this example, `localhost:15555` denotes the local port on Windows
 
     > [!NOTE]
-    > Command line access to `adb` can be obtained in Visual Studio through the **Tools > Android > Android Adb Command Prompt...** menu item.  
+    > Command line access to `adb` can be obtained in Visual Studio through the **Tools > Android > Android Adb Command Prompt...** menu item.
 
 When the connection is completed Visual Studio will display the emulator as a debug target under **Android Local Devices**, which you can use to deploy your app to the emulator.

docs/fundamentals/accessibility.md

@@ -136,13 +136,13 @@ The following example demonstrates setting this attached property:
 <Label Text="Paragraphs of text go here." />
 <Label Text="Installation"
        SemanticProperties.HeadingLevel="Level2" />
-<Label Text="Paragraphs of text go here." />    
+<Label Text="Paragraphs of text go here." />
 <Label Text="Build your first app"
        SemanticProperties.HeadingLevel="Level3" />
-<Label Text="Paragraphs of text go here." />     
+<Label Text="Paragraphs of text go here." />
 <Label Text="Publish your app"
        SemanticProperties.HeadingLevel="Level4" />
-<Label Text="Paragraphs of text go here." />   
+<Label Text="Paragraphs of text go here." />
 ```
 
 Alternatively, it can be set in C#:
@@ -386,7 +386,7 @@ For alternative methods of enabling VoiceOver, see [Turn VoiceOver on or off on
 
 ### Enable Narrator
 
-Narrator is the primary screen reader used on Windows. Narrator can be enabled by pressing the **Windows logo key** + **Ctrl** + **Enter** together. These keys can be pressed again to stop Narrator.
+Narrator is the primary screen reader used on Windows. Narrator can be enabled by pressing the **Windows logo key** + **Ctrl** + **Enter** together. Press these keys again to stop Narrator.
 
 For more information about Narrator, see [Complete guide to Narrator](https://support.microsoft.com/windows/complete-guide-to-narrator-e4397a0d-ef4f-b386-d8ae-c172f109bdb1).
 

docs/get-started/first-app.md

@@ -242,7 +242,7 @@ In this tutorial, you'll create your first .NET MAUI app in Visual Studio Code o
 
     :::image type="content" source="media/first-app/vscode/create-new-project.png" alt-text="Screenshot of the create new project button in Visual Studio Code.":::
 
-    Alternatively, press <kbd>CTRL+SHIFT+P</kbd> on Windows, or <kbd>CMD+SHIFT+P</kbd> on macOS, and then the **.NET: New Project...** command.
+    Alternatively, press <kbd>Ctrl+Shift+P</kbd> on Windows, or <kbd>Cmd+Shift+P</kbd> on macOS, and then the **.NET: New Project...** command.
 
 1. In the command palette, select the **.NET MAUI App** template:
 
@@ -270,14 +270,14 @@ In this tutorial, you'll create your first .NET MAUI app in Visual Studio Code o
 :::zone pivot="devices-android"
 
 <!-- markdownlint-disable MD029 -->
-7. In Visual Studio Code, verify that your Android environment is configured correctly by pressing <kbd>CTRL+SHIFT+P</kbd> on Windows, or <kbd>CMD+SHIFT+P</kbd> on macOS, and then selecting **.NET MAUI: Configure Android**, followed by **Refresh Android environment**. Any detected errors must be addressed.
+7. In Visual Studio Code, verify that your Android environment is configured correctly by pressing <kbd>Ctrl+Shift+P</kbd> on Windows, or <kbd>Cmd+Shift+P</kbd> on macOS, and then selecting **.NET MAUI: Configure Android**, followed by **Refresh Android environment**. Any detected errors must be addressed.
     <!-- markdownlint-enable MD029 -->
 
 1. In the status bar at the bottom of Visual Studio Code, press on the curly brackets symbol **{ }** and ensure that the **Debug Target** is set to a specific Android emulator:
 
     :::image type="content" source="media/first-app/vscode/android-debug-target.png" alt-text="Screenshot of the debug target in Visual Studio Code set to an Android emulator.":::
 
-    You can also set the debug target by pressing <kbd>CTRL+SHIFT+P</kbd> on Windows, or <kbd>CMD+SHIFT+P</kbd> on macOS, and selecting **.NET MAUI: Pick Android Device** from the command palette.
+    You can also set the debug target by pressing <kbd>Ctrl+Shift+P</kbd> on Windows, or <kbd>Cmd+Shift+P</kbd> on macOS, and selecting **.NET MAUI: Pick Android Device** from the command palette.
 
 1. Build and run the app on Android by pressing <kbd>F5</kbd> or by pressing the **Run** button in the upper right corner of Visual Studio Code:
 
@@ -302,14 +302,14 @@ To debug the app on an Android device:
 :::zone pivot="devices-ios"
 
 <!-- markdownlint-disable MD029 -->
-7. In Visual Studio Code, verify that your Apple environment is configured correctly by pressing <kbd>CMD+SHIFT+P</kbd> and then selecting **.NET MAUI: Configure Apple**, followed by **Refresh Apple environment**. Any detected errors must be addressed.
+7. In Visual Studio Code, verify that your Apple environment is configured correctly by pressing <kbd>Cmd+Shift+P</kbd> and then selecting **.NET MAUI: Configure Apple**, followed by **Refresh Apple environment**. Any detected errors must be addressed.
     <!-- markdownlint-enable MD029 -->
 
 1. In the status bar at the bottom of Visual Studio Code, press on the curly brackets symbol **{ }** and ensure that the **Debug Target** is set to a specific iOS simulator:
 
     :::image type="content" source="media/first-app/vscode/ios-debug-target.png" alt-text="Screenshot of the debug target in Visual Studio Code set to an iOS simulator.":::
 
-    You can also set the debug target by pressing <kbd>CMD+SHIFT+P</kbd> and selecting **.NET MAUI: Pick iOS Device** from the command palette.
+    You can also set the debug target by pressing <kbd>Cmd+Shift+P</kbd> and selecting **.NET MAUI: Pick iOS Device** from the command palette.
 
 1. Build and run the app on iOS by pressing <kbd>F5</kbd> or by pressing the **Run** button in the upper right corner of Visual Studio Code:
 
@@ -336,14 +336,14 @@ To debug the app on an iOS device:
 :::zone pivot="devices-maccatalyst"
 
 <!-- markdownlint-disable MD029 -->
-7. In Visual Studio Code, verify that your Apple environment is configured correctly by pressing <kbd>CMD+SHIFT+P</kbd> and then selecting **.NET MAUI: Configure Apple**, followed by **Refresh Apple environment**. Any detected errors must be addressed.
+7. In Visual Studio Code, verify that your Apple environment is configured correctly by pressing <kbd>Cmd+Shift+P</kbd> and then selecting **.NET MAUI: Configure Apple**, followed by **Refresh Apple environment**. Any detected errors must be addressed.
     <!-- markdownlint-enable MD029 -->
 
 1. In the status bar at the bottom of Visual Studio Code, press on the curly brackets symbol **{ }** and ensure that the **Debug Target** is set to your Mac:
 
     :::image type="content" source="media/first-app/vscode/mac-debug-target.png" alt-text="Screenshot of the debug target in Visual Studio Code set to macOS.":::
 
-    You can also set the debug target by pressing <kbd>CMD+SHIFT+P</kbd> and selecting **.NET MAUI: Pick macOS Device** from the command palette.
+    You can also set the debug target by pressing <kbd>Cmd+Shift+P</kbd> and selecting **.NET MAUI: Pick macOS Device** from the command palette.
 
 1. Build and run the app on macOS by pressing <kbd>F5</kbd> or by pressing the **Run** button in the upper right corner of Visual Studio Code:
 
@@ -364,7 +364,7 @@ To debug the app on an iOS device:
 
     :::image type="content" source="media/first-app/vscode/windows-debug-target.png" alt-text="Screenshot of the debug target in Visual Studio Code set to Windows.":::
 
-    You can also set the debug target by pressing <kbd>CTRL+SHIFT+P</kbd> and selecting **.NET MAUI: Pick Windows Device** from the command palette.
+    You can also set the debug target by pressing <kbd>Ctrl+Shift+P</kbd> and selecting **.NET MAUI: Pick Windows Device** from the command palette.
     <!-- markdownlint-enable MD029 -->
 
 1. Build and run the app on Windows by pressing <kbd>F5</kbd> or by pressing the **Run** button in the upper right corner of Visual Studio Code:

docs/get-started/installation.md

@@ -196,7 +196,7 @@ To download and install the Java SDK, and configure Visual Studio Code to use it
         > [!NOTE]
         > If you install the OpenJDK on Windows via MSI, you can opt into the installer setting the `JAVA_HOME` environmental variable.
 
-    1. In Visual Studio Code, press <kbd>CTRL+SHIFT+P</kbd> on Windows, or <kbd>CMD+SHIFT+P</kbd> on macOS, and then select **.NET MAUI: Configure Android**, followed by **Select Java SDK location** to set the Java SDK path at the user/workspace level.
+    1. In Visual Studio Code, press <kbd>Ctrl+Shift+P</kbd> on Windows, or <kbd>Cmd+Shift+P</kbd> on macOS, and then select **.NET MAUI: Configure Android**, followed by **Select Java SDK location** to set the Java SDK path at the user/workspace level.
     1. Configure the Java SDK path in your .csproj file by setting the `$(JavaSdkDirectory)` MSBuild property to the OpenJDK path. This will define the Java SDK path at the project level.
 
 #### Download and install the Android SDK
@@ -211,10 +211,10 @@ To download and install the Android SDK, and configure Visual Studio Code to use
 
 1. Ensure that you've configured the path to the Android SDK via one of the following approaches:
     1. Set the `ANDROID_HOME` environment variable to define the Android SDK path for your machine. This is the recommended approach, which defines the Android SDK path at the machine level.
-    1. In Visual Studio Code, press <kbd>CTRL+SHIFT+P</kbd> on Windows, or <kbd>CMD+SHIFT+P</kbd> on macOS, and then select **.NET MAUI: Configure Android**, followed by **Select Android SDK location** to set the Android SDK path at the user/workspace level.
+    1. In Visual Studio Code, press <kbd>Ctrl+Shift+P</kbd> on Windows, or <kbd>Cmd+Shift+P</kbd> on macOS, and then select **.NET MAUI: Configure Android**, followed by **Select Android SDK location** to set the Android SDK path at the user/workspace level.
     1. Configure the Android SDK path in your .csproj file by setting the `$(AndroidSdkDirectory)` MSBuild property to the Android SDK path. This will define the Android SDK path at the project level.
 
-1. In Visual Studio Code, verify that your Android environment is configured correctly by pressing <kbd>CTRL+SHIFT+P</kbd> on Windows, or <kbd>CMD+SHIFT+P</kbd> on macOS, and then selecting **.NET MAUI: Configure Android**, followed by **Refresh Android environment**. Any detected errors must be addressed:
+1. In Visual Studio Code, verify that your Android environment is configured correctly by pressing <kbd>Ctrl+Shift+P</kbd> on Windows, or <kbd>Cmd+Shift+P</kbd> on macOS, and then selecting **.NET MAUI: Configure Android**, followed by **Refresh Android environment**. Any detected errors must be addressed:
     - In the command palette, select **.NET MAUI: Configure Android** followed by both **Select Android SDK location** and **Select Android SDK location** and validate that they correctly point to installations of each. On Windows, if you install the SDKs via Visual Studio, OpenJDK will be located at *C:\Program Files\Microsoft* and the Android SDK will be located at *C:\Program Files (x86)\Android\android-sdk*.
     - Ensure that your Android SDK folder has sub-folders such as *build-tools*, *cmdline-tools*, and *platform-tools*.
     - Ensure that your OpenJDK folder has sub-folders such as *bin*, *lib*, and more.
@@ -307,14 +307,14 @@ To set up your Mac for .NET MAUI development on iOS and Mac Catalyst with Visual
     ```
 
 1. Launch Xcode and accept any license agreements. If simulators don't start installing, navigate to **Xcode > Settings > Components** and install your chosen simulator runtimes.
-1. In Visual Studio Code, verify that your Apple environment is configured correctly by pressing <kbd>CMD+SHIFT+P</kbd> and then selecting **.NET MAUI: Configure Apple**, followed by **Refresh Apple environment**. Any detected errors must be addressed:
+1. In Visual Studio Code, verify that your Apple environment is configured correctly by pressing <kbd>Cmd+Shift+P</kbd> and then selecting **.NET MAUI: Configure Apple**, followed by **Refresh Apple environment**. Any detected errors must be addressed:
     - Ensure you've ran `xcode-select --install` in a terminal.
     - If you receive an error that Xcode hasn't been found, run `xcode-select -p` in a terminal and check that it returns a path to your Xcode installation.
     - Open Xcode to ensure it loads correctly, and then navigate to **Xcode > Settings > Location** and check that the **Command Line Tools** field is pointing to the correct Xcode installation.
 
 ## Troubleshooting
 
-If you encounter issues when installing the .NET MAUI extension in Visual Studio Code, more information about the issues can be found by navigating to the **Output** window (<kbd>CTRL+SHIFT+U</kbd> on Windows or <kbd>CMD+SHIFT+U</kbd> on macOS) and selecting **.NET MAUI** in the drop-down.
+If you encounter issues when installing the .NET MAUI extension in Visual Studio Code, more information about the issues can be found by navigating to the **Output** window (<kbd>Ctrl+Shift+U</kbd> on Windows or <kbd>Cmd+Shift+U</kbd> on macOS) and selecting **.NET MAUI** in the drop-down.
 
 ## Provide feedback
 
@@ -387,7 +387,7 @@ This walkthrough can also be accessed from the command palette. Select **Welcome
 
 ### Access the improved setup experience
 
-1. In Visual Studio Code, press <kbd>CTRL+SHIFT+P</kbd> on Windows, or <kbd>CMD+SHIFT+P</kbd> on macOS, select **Preferences: Open Settings (UI)**.
+1. In Visual Studio Code, press <kbd>Ctrl+Shift+P</kbd> on Windows, or <kbd>Cmd+Shift+P</kbd> on macOS, select **Preferences: Open Settings (UI)**.
 
     :::image type="content" source="media/installation/vscode/settings.png" alt-text="Screenshot of the Visual Studio Code settings menu option.":::
 

docs/macios/xcsync.md

@@ -46,11 +46,11 @@ dotnet tool install dotnet-xcsync -g --prerelease --add-source https://pkgs.dev.
 
 ## Troubleshooting
 
-To see details on errors related to xcsync, navigate to the **Output** window (<kbd>CMD + Shift + u </kbd>) and select **.NET MAUI - xcsync** in the drop-down. If you are facing issues, please [report an issue](#provide-feedback).
+To see details on errors related to xcsync, navigate to the **Output** window (<kbd>Cmd + Shift + U</kbd>) and select **.NET MAUI - xcsync** in the drop-down. If you are facing issues, please [report an issue](#provide-feedback).
 
 ## Provide feedback
 
-Please check existing [Known Issues](https://github.com/dotnet/xcsync/issues) before filing a new issue or suggestion.
+Please check existing [Known issues](https://github.com/dotnet/xcsync/issues) before filing a new issue or suggestion.
 
 <!-- markdownlint-disable MD025 -->
 # [CLI](#tab/cli)