Add new troubleshooting options with descriptions (#4106)

* Add new troubleshooting options with descriptions

* Fix anchor warnings

Author: mattwojo

landing/arm-docs/apps-on-arm-program-compat-troubleshooter.md

@@ -1,7 +1,7 @@
 ---
 title: Program Compatibility Troubleshooter on Arm
 description: Guidance for adjusting compatibility settings if your app isn't working correctly on Arm
-ms.date: 06/25/2021
+ms.date: 02/23/2024
 ms.topic: article
 ms.service: windows
 ms.subservice: arm
@@ -12,19 +12,26 @@ ms.reviewer: marcs
 
 # Program Compatibility Troubleshooter on Arm
 
-Emulation to support x86 apps is a new feature created for Windows on Arm64. Sometimes the emulation performs optimizations that don't result in the best experience. You can use the Program Compatibility Troubleshooter to toggle emulation settings for your x86 app, reducing the default optimizations and potentially increasing compatibility.
+PCs powered by Arm provide great application compatibility and allow you to run your existing unmodified x86 win32 applications. Arm apps run natively without any emulation, while x86 and x64 apps run under emulation on Arm devices.
+
+However, sometimes the emulation performs optimizations that don't result in the best user experience. You can use the **Program Compatibility Troubleshooter** to toggle emulation settings for your x86 or x64 app, reducing the default optimizations and potentially increasing compatibility.
 
 ## Start the Program Compatibility Troubleshooter
 
-You start the [Program Compatibility Troubleshooter](https://support.microsoft.com/help/15078/windows-make-older-programs-compatible) manually in the same way on any Windows PC: right-click an executable (.exe) file and select **Troubleshoot compatibility**. This screen appears.
+You start the [Program Compatibility Troubleshooter](https://support.microsoft.com/help/15078/windows-make-older-programs-compatible) manually in the same way on any Windows PC: right-click an executable (.exe) file and select **Troubleshoot compatibility**. You will then have the option to *Try recommended settings* to test run the program using recommended compatibility settings or *Troubleshoot program* to choose compatibility settings based on specific problems that you've noticed.
 
 ![Screenshot of the Troubleshoot compatibility options.](images/Capture4.png)
 
-If you click on **Troubleshoot program** you will be presented with the following options.
+If you select **Troubleshoot program**, you will have the option to select:
+
+- The program worked in earlier versions of Windows but won't install or run now
+- The program opens but doesn't display correctly
+- The program requires additional permissions
+- I don't see my problem listed
 
 ![Screenshot of the What problems do you notice options.](images/Capture5.png)
 
-All options enable the settings that are applicable and applied on Windows Desktop PCs. In addition, the first, second, and fourth options apply the [Disable application cache](#disable-app-cache) and [Disable hybrid execution mode](#disable-hybrid-exec-mode) emulation settings.
+All options enable the settings that are applicable and applied on Windows Desktop PCs. In addition, the first, second, and fourth options apply the `Disable application cache` and `Disable hybrid execution mode` emulation settings. (See the emulation settings table below for descriptions.)
 
 ## Toggling emulation settings
 
@@ -33,26 +40,29 @@ All options enable the settings that are applicable and applied on Windows Deskt
 
 You can toggle emulation settings by right-clicking the executable and selecting **Properties**.
 
-On ARM, a section titled **Windows 10 on ARM** or **Windows 11 on ARM** will be available in the **Compatibility** tab. Click **Change emulation settings** to launch a second window as here.
+On ARM, a section titled **Windows 10 on ARM** or **Windows 11 on ARM** will be available in the **Compatibility** tab. Select **Change emulation settings** to launch an Emulations Properties window.
 
 ![Change emulation settings screenshot](images/Capture.png)
 
-This window provides two ways to modify emulation settings. You may select a pre-defined group of emulation settings, or you may click the **Use advanced settings** option to enable choosing individual settings.
+This Emulations Properties window provides two ways to modify emulation settings. You may select a pre-defined group of emulation settings or select the **Use advanced settings** option to enable choosing individual settings.
 
-The grouped emulation settings reduce performance optimizations in favor of quality. Below are some grouped settings that you can select.
+The following emulation settings reduce performance optimizations in favor of quality and can be used to experiment with testing your x86 or x64 app's compatibility when running in Windows on Arm.
 
 ![Change emulation settings screenshot2](images/Capture2.png)
 
 Select **Use advanced settings** to choose individual settings as described in this table.
 
 | Emulation setting | Result |
 | ----------------- | ----------- |
-| <p id="disable-app-cache">Disable application cache</p> | The operating system will cache compiled blocks of code to reduce emulation overhead on subsequent executions. This setting requires the emulator to recompile all app code at runtime. |
-| <p id="disable-hybrid-exec-mode">Disable hybrid execution mode</p> | Compiled Hybrid Portable Executable (CHPE), binaries are x86 compatible binaries that include native Arm64 code to improve performance, but that may not be compatible with some apps. This setting forces use of x86-only binaries. |
+| Disable application cache | The operating system will cache compiled blocks of code to reduce emulation overhead on subsequent executions. This setting requires the emulator to recompile all app code at runtime. |
+| Disable hybrid execution mode | Compiled Hybrid Portable Executable (CHPE), binaries are x86 compatible binaries that include native Arm64 code to improve performance, but that may not be compatible with some apps. This setting forces use of x86-only binaries. |
+| Additional lightweight emulation protections | A catch-all update affecting things like volatile metadata which can impact performance when running an x86 or x64 app in emulation. |
 | Strict self-modifying code support | Enable this to ensure that any self-modifying code is correctly supported in emulation. The most common self-modifying code scenarios are covered by the default emulator behavior. Enabling this option significantly reduces performance of self-modifying  code during execution. |
 | Disable RWX page performance optimization | This optimization improves the performance of code on readable, writable, and executable (RWX) pages, but may be incompatible with some apps. |
+| Disable JIT optimization (x64 apps only) | This is no longer used and will be removed in future versions of the Troubleshooter. |
+| Disable floating point optimization (x64 apps only) | Check to emulate x87 floating point at a full 80-bit precision, but at  a performance cost. x87 is a floating-point coprocessor used in some older x86 processors to perform floating-point arithmetic using an 80-bit floating point format with higher precision than the 32-bit or 64-bit format. |
 
-You can also select multi-core settings, as shown here.
+You can also change how the application uses multiple CPU cores, selecting between Fast, Strict multi-core operation, Very strict, or Force single-core operation. Test your apps emulation when running Windows on Arm with these settings if you notice compatibility issues.
 
 ![Multi-core settings screenshot](images/Capture3.png)