From 9a130a3a0fb1e4eb3d7dc29c55feede518e6193f Mon Sep 17 00:00:00 2001
From: Eirik Tsarpalis <eirik.tsarpalis@gmail.com>
Date: Tue, 17 Jan 2023 15:12:57 +0000
Subject: [PATCH] Update JsonSerializerOptions.AddContext documentation.

---
 .../JsonTypeInfoResolver.xml                                 | 2 +-
 xml/System.Text.Json/JsonSerializerOptions.xml               | 5 ++++-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfoResolver.xml b/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfoResolver.xml
index 436fcd24ec3..37a935dc9c3 100644
--- a/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfoResolver.xml
+++ b/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfoResolver.xml
@@ -63,7 +63,7 @@ Can be used to combine multiple <xref:System.Text.Json.Serialization.JsonSeriali
           ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">
-          <paramref name="resolvers" /> or any of its elements is <see langword="null" />.</exception>
+          <paramref name="resolvers" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
   </Members>
diff --git a/xml/System.Text.Json/JsonSerializerOptions.xml b/xml/System.Text.Json/JsonSerializerOptions.xml
index 03e2e454cb2..3c90241657f 100644
--- a/xml/System.Text.Json/JsonSerializerOptions.xml
+++ b/xml/System.Text.Json/JsonSerializerOptions.xml
@@ -126,7 +126,7 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa
       <Parameters />
       <Docs>
         <typeparam name="TContext">The generic definition of the specified context type.</typeparam>
-        <summary>Binds current <see cref="T:System.Text.Json.JsonSerializerOptions" /> instance with a new instance of the specified <see cref="T:System.Text.Json.Serialization.JsonSerializerContext" /> type.</summary>
+        <summary>Appends a new <see cref="T:System.Text.Json.Serialization.JsonSerializerContext" /> to the metadata resolution of the current <see cref="T:System.Text.Json.JsonSerializerOptions" /> instance.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
@@ -134,6 +134,9 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa
 
 When serializing and deserializing types using the options instance, metadata for the types will be fetched from the context instance.
 
+The methods supports adding multiple contexts per options instance. Metadata will be resolved in the order of configuration, 
+similar to how <xref:System.Text.Json.Serialization.Metadata.JsonTypeInfoResolver.Combine /> resolves metadata.
+
           ]]></format>
         </remarks>
       </Docs>