Merge pull request #8472 from paulcociuba/patch-3

AB#4649: Docs 2024 Review - Update disable-debugging-application.md

Author: sevend2

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

@@ -1,13 +1,14 @@
 ---
-title: Disable debugging for ASP.NET application
+title: Disable Debugging for ASP.NET Application
 description: This article discusses how to disable debugging for ASP.NET applications.
-ms.date: 03/27/2020
+ms.date: 03/26/2025
 ms.custom: sap:General Development
 ms.topic: how-to
+ms.reviewer: paulboc
 ---
 # Disable debugging for ASP.NET applications
 
-This article discusses how to disable debugging for ASP.NET applications.
+This article discusses how to disable debugging for ASP.NET applications running on .NET Framework.
 
 _Original product version:_   ASP.NET  
 _Original KB number:_   815157
@@ -18,38 +19,68 @@ ASP.NET supports compiling applications in a special debug mode that helps devel
 
 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.
 
-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
 
-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.
+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.
 
-    The following code sample shows the compilation element with debug set to **false**:
+    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.
+4. Save the **Web.config** file. The ASP.NET application automatically restarts.
 
 ## Method 2: Modify the Machine.config file
 
-You can also disable debugging for all applications on a system by modifying the *Machine.config* file. To confirm debugging hasn't been enabled in the *Machine.config* file, follow these steps:
+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 the *Machine.config* file in a text editor, such as Notepad. The file is typically located in the following folder:  
+1. Open the **Machine.config** file in a text editor, such as Notepad. The file is typically located in the following folder:  
 
-    `%SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\`
-2. In the *Machine.config* file, locate the compilation element. Debugging is enabled when the debug attribute in the compilation element is set to **true**.
-3. If the debug attribute is **true**, change the debug attribute to **false**.
+   `%SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\`
 
-    The following code sample shows the compilation element with debug set to **false**:
+   For 64-bit versions of the .NET Framework, the file is in the following folder:
 
-    ```xml
-    <compilation debug="false"/>
-    ```
+   `%SystemRoot%\Microsoft.NET\Framework64\%VersionNumber%\CONFIG\`
+
+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`.
+
+   The following code sample shows the compilation element with debug set to `false`:
+
+   ```xml
+   <compilation debug="false"/>
+   ```
+
+1. Save the **Machine.config** file.
+
+## Method 3: Using IIS Manager (if the web application is hosted on IIS)
+
+1. Open IIS Manager on the computer where the website is hosted (you can select <kbd>Windows</kbd> + <kbd>R</kbd> and type **inetmgr**):
+
+   :::image type="content" source="media/disable-debugging-application/type-inetmgr-run-window.png" alt-text="Screenshot of typing inetmgr in the Run window.":::
+
+1. Select the website or web application for which you want to enable or disable debug mode from the left-hand side tree view:
+
+   :::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. From the middle pane of IIS Manager, select the **.NET Compilation** icon:
+
+   :::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":::
+
+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:
+
+   - **True**: Enable debug mode.
+   - **False**: Disable debug mode.
+
+   :::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":::
+
+1. Select the **Apply** button from the right-hand side pane of IIS Manager to save the changes to the IIS configuration:
 
-4. Save the *Machine.config* file.
+   :::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":::