Pull in PR and make edits

Author: haywoodsloan

support/developer/webapps/aspnet/development/disable-debugging-application.md

@@ -4,85 +4,86 @@ description: This article discusses how to disable debugging for ASP.NET applica
 ms.date: 03/26/2025
 ms.custom: sap:General Development
 ms.topic: how-to
-ms.reviewer: paulboc
+ms.reviewer: paulboc, v-shaywood
 ---
 # Disable debugging for ASP.NET applications
 
-This article discusses how to disable debugging for ASP.NET applications running on .NET Framework.
+This article explains how to disable debugging for ASP.NET applications running on .NET Framework.
 
 _Original product version:_   ASP.NET  
 _Original KB number:_   815157
 
 ## Summary
 
-ASP.NET supports compiling applications in a special debug mode that helps developer troubleshooting. Debug mode causes ASP.NET to compile applications with extra information. The information enables a debugger to closely monitor and control the execution of an application. Applications that are compiled in debug mode execute as expected. However, the performance of the application is affected. To avoid the effect on performance, it's a good idea to enable debugging only when a developer is doing interactive troubleshooting.
+ASP.NET supports compiling applications in a special debug mode that helps developers troubleshoot. Debug mode causes ASP.NET to compile applications with extra information. The extra information enables a debugger to closely monitor and control the execution of an application. Applications that are compiled in debug mode execute as expected. However, the performance of the application is affected. To avoid the effect on performance, enable debugging only when a developer is doing interactive troubleshooting.
 
-Debugging is disabled by default. Debugging is frequently enabled to troubleshoot a problem. But it's frequently not disabled after the problem is resolved. This article describes how to disable debugging for an ASP.NET application.
+Debugging is disabled by default. Developers frequently enable debugging to troubleshoot a problem but don't disable it after the problem is resolved. This article describes how to disable debugging for an ASP.NET application.
 
-To disable debugging, modify the **Web.config** file or the **Machine.config** file, as detailed in the following sections.
+To disable debugging, modify the `Web.config` file or the `Machine.config` file, as detailed in the following sections.
 
-## Method 1: Modify the Web.config file
+## Modify the Web.config file
 
-To disable debugging, add the compilation element to the **Web.config** file of the application by following these steps. The **Web.config** file is located in the application directory.
+To disable debugging, add the compilation element to the `Web.config` file of the application by following these steps. The `Web.config` file is located in the application directory.
 
-1. Open the **Web.config** file in a text editor, such as Notepad. The file is typically located in the application directory.
-2. In the **Web.config** file, locate the compilation element. Debugging is enabled when the debug attribute in the compilation element is set to `true`.
-3. Change the debug attribute to `false` to disable debugging for that application.
+1. Open the `Web.config` file in a text editor, such as Notepad. The file is typically located in the application directory.
+1. In the `Web.config` file, locate the compilation element. Debugging is enabled when the debug attribute in the compilation element is set to `true`.
+1. Change the debug attribute to `false` to disable debugging for that application.
 
     The following code sample shows the compilation element with debug set to `false`:
 
     ```xml
     <compilation debug="false"/>
     ```
 
-4. Save the **Web.config** file. The ASP.NET application automatically restarts.
+1. Save the `Web.config` file. The ASP.NET application automatically restarts.
 
-## Method 2: Modify the Machine.config file
+## Use IIS Manager (if the web application is hosted on IIS)
 
-You can also disable debugging for all applications on a system by modifying the **Machine.config** file. To confirm that debugging isn't enabled in the **Machine.config** file, follow these steps:
+1. Open IIS Manager on the computer where the website is hosted. You can select <kbd>Windows</kbd> + <kbd>R</kbd> and type **inetmgr**:
 
-1. Open the **Machine.config** file in a text editor, such as Notepad. The file is typically located in the following folder:  
+   :::image type="content" source="media/disable-debugging-application/type-inetmgr-run-window.png" alt-text="Screenshot of typing inetmgr in the Run window.":::
 
-   `%SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\`
+1. Select the website or web application for which you want to enable or disable debug mode from the left-hand side tree view:
 
-   For 64-bit versions of the .NET Framework, the file is in the following folder:
+   :::image type="content" source="media/disable-debugging-application/enable-disable-debug-mode-web-application.png" alt-text="Screenshot of website or web application for which you want to enable or disable debug mode." lightbox="media/disable-debugging-application/enable-disable-debug-mode-web-application.png":::
 
-   `%SystemRoot%\Microsoft.NET\Framework64\%VersionNumber%\CONFIG\`
+1. From the middle pane of IIS Manager, select the **.NET Compilation** icon:
 
-1. In the **Machine.config** file, locate the compilation element. Debugging is enabled when the debug attribute in the compilation element is set to `true`.
-1. If the debug attribute is `true`, change the debug attribute to `false`.
+   :::image type="content" source="media/disable-debugging-application/net-compilation-icon.png" alt-text="Screenshot of the .NET Compilation icon." lightbox="media/disable-debugging-application/net-compilation-icon.png":::
 
-   The following code sample shows the compilation element with debug set to `false`:
+1. In the list of parameter values displayed in the middle pane of IIS Manager, set the value of **Debug** under the **Behavior** category to:
 
-   ```xml
-   <compilation debug="false"/>
-   ```
+   - **True**: Enable debug mode.
+   - **False**: Disable debug mode.
 
-1. Save the **Machine.config** file.
+   :::image type="content" source="media/disable-debugging-application/set-value-debug-under-behavior-category.png" alt-text="Screenshot of setting the value of Debug under the Behavior category." lightbox="media/disable-debugging-application/set-value-debug-under-behavior-category.png":::
 
-**Caution** : Do not directly edit Machine.config unless you fully understand the impact. This file applies globally to all .NET applications on the server, and mistakes can break other applications. Prefer setting debug="false" in the application’s Web.config or via IIS Manager to target only specific sites.
+1. Select the **Apply** button from the right-hand side pane of IIS Manager to save the changes to the IIS configuration:
 
-## Method 3: Using IIS Manager (if the web application is hosted on IIS)
+   :::image type="content" source="media/disable-debugging-application/apply-button-iis-manager.png" alt-text="Screenshot of the Apply button in IIS Manager." lightbox="media/disable-debugging-application/apply-button-iis-manager.png":::
 
-1. Open IIS Manager on the computer where the website is hosted (you can select <kbd>Windows</kbd> + <kbd>R</kbd> and type **inetmgr**):
+## Modify the Machine.config file
 
-   :::image type="content" source="media/disable-debugging-application/type-inetmgr-run-window.png" alt-text="Screenshot of typing inetmgr in the Run window.":::
+> [!CAUTION]
+> Be careful when editing `Machine.config`. This file applies globally to all .NET applications on the server, and a misconfiguration can break other applications. Prefer setting `debug="false"` in the application’s Web.config or via IIS Manager to target only specific sites.
 
-1. Select the website or web application for which you want to enable or disable debug mode from the left-hand side tree view:
+You can also disable debugging for all applications on a system by modifying the `Machine.config` file. To confirm that debugging isn't enabled in the `Machine.config` file, follow these steps:
 
-   :::image type="content" source="media/disable-debugging-application/enable-disable-debug-mode-web-application.png" alt-text="Screenshot of website or web application for which you want to enable or disable debug mode." lightbox="media/disable-debugging-application/enable-disable-debug-mode-web-application.png":::
+1. Open the `Machine.config` file in a text editor, such as Notepad. The file is typically located in the following folder:  
 
-1. From the middle pane of IIS Manager, select the **.NET Compilation** icon:
+   `%SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\`
 
-   :::image type="content" source="media/disable-debugging-application/net-compilation-icon.png" alt-text="Screenshot of the .NET Compilation icon." lightbox="media/disable-debugging-application/net-compilation-icon.png":::
+   For 64-bit versions of the .NET Framework, the file is in the following folder:
 
-1. Within the list of parameter values displayed in the middle pane of IIS Manager, set the value of **Debug** under the **Behavior** category to:
+   `%SystemRoot%\Microsoft.NET\Framework64\%VersionNumber%\CONFIG\`
 
-   - **True**: Enable debug mode.
-   - **False**: Disable debug mode.
+1. In the `Machine.config` file, locate the compilation element. Debugging is enabled when the debug attribute in the compilation element is set to `true`.
+1. If the debug attribute is `true`, change the debug attribute to `false`.
 
-   :::image type="content" source="media/disable-debugging-application/set-value-debug-under-behavior-category.png" alt-text="Screenshot of setting the value of Debug under the Behavior category." lightbox="media/disable-debugging-application/set-value-debug-under-behavior-category.png":::
+   The following code sample shows the compilation element with debug set to `false`:
 
-1. Select the **Apply** button from the right-hand side pane of IIS Manager to save the changes to the IIS configuration:
+   ```xml
+   <compilation debug="false"/>
+   ```
 
-   :::image type="content" source="media/disable-debugging-application/apply-button-iis-manager.png" alt-text="Screenshot of the Apply button in IIS Manager." lightbox="media/disable-debugging-application/apply-button-iis-manager.png":::
+1. Save the `Machine.config` file.