From ea2870f43a448c431084e669937cbce25e30d04d Mon Sep 17 00:00:00 2001
From: Caleb-D <35500148+Caleb-D@users.noreply.github.com>
Date: Fri, 5 May 2023 08:46:22 -0700
Subject: [PATCH] Update TaskContinuationOptions.xml

add note on usage of NotOnFaulted regarding chains of continuation tasks
---
 xml/System.Threading.Tasks/TaskContinuationOptions.xml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/xml/System.Threading.Tasks/TaskContinuationOptions.xml b/xml/System.Threading.Tasks/TaskContinuationOptions.xml
index 00cc09b9b51..b224d7678d3 100644
--- a/xml/System.Threading.Tasks/TaskContinuationOptions.xml
+++ b/xml/System.Threading.Tasks/TaskContinuationOptions.xml
@@ -394,7 +394,10 @@
       </ReturnValue>
       <MemberValue>262144</MemberValue>
       <Docs>
-        <summary>Specifies that the continuation task should not be scheduled if its antecedent was canceled. An antecedent is canceled if its <see cref="P:System.Threading.Tasks.Task.Status" /> property upon completion is <see cref="F:System.Threading.Tasks.TaskStatus.Canceled" />. This option is not valid for multi-task continuations.</summary>
+        <summary>Specifies that the continuation task should not be scheduled if its antecedent was canceled. An antecedent is canceled if its <see cref="P:System.Threading.Tasks.Task.Status" /> property upon completion is <see cref="F:System.Threading.Tasks.TaskStatus.Canceled" />. This option is not valid for multi-task continuations.  
+        
+          Note: if you intend that a chain of continuation tasks should stop when one of the tasks throws an exception, use the flag <see cref="OnlyOnRanToCompletion"/> on all the continuation tasks instead of <see cref="NotOnFaulted"/>.
+        </summary>
       </Docs>
     </Member>
     <Member MemberName="NotOnFaulted">