Added some formatting suggestions. Reworded the caution tip at the top. Added the suggested section at the top "When To Use A HAR File". Added a new section towards the bottom, "Viewing A HAR File"

Author: ProgrammerAL

src/content/docs/identityserver/troubleshooting/export-har-files.md

@@ -10,15 +10,20 @@ sidebar:
 [HTTP Archive (HAR)](https://en.wikipedia.org/wiki/HAR_(file_format)) files are logs of network interactions made by a web browser. They contain headers, request bodies, response payloads, and even sensitive information like cookie values sent and received for each interaction.
 
 :::caution[Do not share sensitive information]
-Before sharing any HAR files that contain sensitive values for diagnosing, you can sanitize that data by following the [steps below](#sanitize-a-har-file).
+Before sharing HAR files you should ensure they do not contain any sensitive information. You can sanitize a file by following the [steps below](#sanitize-a-har-file).
 :::
 
+## When To Use A HAR File
+
+Because HAR files are traces of all network interactions within the browser, they are commonly shared with another party to help diagnose issues. A common scenario is when there are multiple services involved with a use case. You can imagine an application where a user logs in to a site with Duende IdentityServer on the backend, and an external IdP storing the user account. That scenario has three distinct applications and the HAR file is used to trace if/when certain cookies are set within the login flow.
+
 ## HAR File Considerations
 
-* Consider using an **incognito window** of your browser. If you do, close all browser incognito instances you may have open and then open a new one before creating the HAR file to ensure the cache is cleared.
-* Preserve the log across page navigations
-  * If you are navigating to different pages (ex: logging in to a site with OAuth redirects), then any network calls made before the last redirect will be lost. Preserving the logs across page navigations aids in diagnosing issues. The below steps include instructions to preserve network logs while navigating across multiple pages.
-* Generate HAR files with sensitive data
+* Consider using an **incognito window** of your browser.
+  * If you do, close all browser incognito instances you may have open and then open a new window to ensure the cache is cleared.
+* Preserve the log across page navigation.
+  * If you are navigating to different pages (ex: logging in to a site with OAuth redirects), then any network calls made before the last redirect will be lost. Preserving the logs across page navigation aids in diagnosing issues. The below steps include instructions to preserve network logs while navigating across multiple pages.
+* Generate HAR files with sensitive data.
   * It is helpful to know that certain fields are have been set, but not necessarily the actual value. Some browsers will exclude sensitive data in HAR file exports by default. The below steps include instructions to enable sensitive data in HAR file exports for browsers that do not include it by default.
 
 ## Generating A HAR File
@@ -55,6 +60,10 @@ Generating a HAR file involves steps using your web browser and its associated d
 1. In the browser, visit the page(s) and perform the steps that trigger the issue.
 1. In the Network tab of the dev tools, click the down arrow and select the "Export HAR (with sensitive data)..." option to export the HAR file and save it locally.
 
+## Viewing A HAR File
+
+HAR files are JSON files with a specific file extension. You can open one with any text editor you would normally open JSON files with. You can also import the HAR file into your browser dev tools to visualize it the same way you could see network interactions before exporting the file.
+
 ## Sanitize A HAR File
 
 Before sharing your HAR file with anyone, you should remove any sensitive data. You can do this manually by opening the HAR file with any JSON text editor and removing the sensitive data. We recommend replacing the data with a placeholder rather than deleting the entry. When diagnosing issues, it's helpful to know whether a field was set.
@@ -66,4 +75,4 @@ If you would like to practice with a small sample, you can login to the Duende D
 1. In your browser, navigate to <https://demo.duendesoftware.com/Account/Login>.
 1. With your browser and dev tools open, the log being preserved, and the ability to export a HAR file with sensitive data, login to the site using one of the built-in users.
 1. Export the HAR file with sensitive data.
-1. Explore the HAR file JSON with a text editor.
+1. Explore the HAR file JSON with a text editor or import it into your browser dev tools.