From f6b16acc83a0b1cec8065ba07834291533e6fe0e Mon Sep 17 00:00:00 2001
From: Cole Tobin <coleharrisjohnson@gmail.com>
Date: Sat, 24 Dec 2022 21:09:21 -0500
Subject: [PATCH 1/3] Document `Exception.StackTrace` nullability

Fixes #8728.
---
 xml/System/Exception.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/xml/System/Exception.xml b/xml/System/Exception.xml
index a0367e81085..8b9f6d4b93a 100644
--- a/xml/System/Exception.xml
+++ b/xml/System/Exception.xml
@@ -1364,7 +1364,7 @@ Stack Trace:
       </ReturnValue>
       <Docs>
         <summary>Gets a string representation of the immediate frames on the call stack.</summary>
-        <value>A string that describes the immediate frames of the call stack.</value>
+        <value>A string that describes the immediate frames of the call stack. If no stack trace is available (such as prior to being thrown), this will be `null`.</value>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   

From 8a4fd85e1aaee51d51e7fed1d33e7fba0327da7d Mon Sep 17 00:00:00 2001
From: Cole Tobin <coleharrisjohnson@gmail.com>
Date: Tue, 27 Dec 2022 21:15:32 -0500
Subject: [PATCH 2/3] Update `Exception.xml` with suggestion

---
 xml/System/Exception.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/xml/System/Exception.xml b/xml/System/Exception.xml
index 8b9f6d4b93a..bd48d7d925a 100644
--- a/xml/System/Exception.xml
+++ b/xml/System/Exception.xml
@@ -1364,7 +1364,7 @@ Stack Trace:
       </ReturnValue>
       <Docs>
         <summary>Gets a string representation of the immediate frames on the call stack.</summary>
-        <value>A string that describes the immediate frames of the call stack. If no stack trace is available (such as prior to being thrown), this will be `null`.</value>
+        <value>A string that describes the immediate frames of the call stack. If no stack trace is available (such as prior to stack unwinding from a `throw` statement), this will be `null`.</value>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   

From 9f15c39786b8fbb83c267b0a1f6ea71ad58521d4 Mon Sep 17 00:00:00 2001
From: Cole Tobin <coleharrisjohnson@gmail.com>
Date: Sun, 7 May 2023 10:15:32 -0400
Subject: [PATCH 3/3] Update xml/System/Exception.xml

Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
---
 xml/System/Exception.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/xml/System/Exception.xml b/xml/System/Exception.xml
index bd48d7d925a..4f8b1377ef0 100644
--- a/xml/System/Exception.xml
+++ b/xml/System/Exception.xml
@@ -1364,7 +1364,7 @@ Stack Trace:
       </ReturnValue>
       <Docs>
         <summary>Gets a string representation of the immediate frames on the call stack.</summary>
-        <value>A string that describes the immediate frames of the call stack. If no stack trace is available (such as prior to stack unwinding from a `throw` statement), this will be `null`.</value>
+        <value>A string that describes the immediate frames of the call stack. If no stack trace is available (such as prior to stack unwinding from a <see langword="throw" /> statement), the value is <see langword="null" />.</value>
         <remarks>
           <format type="text/markdown"><![CDATA[