From 61d39c4b1858f2e5e144a5e0bf1263ccb7f1db9c Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 27 Jul 2026 23:11:39 +0000
Subject: [PATCH 1/3] docs: deduplicate XML documentation with inheritdoc cref

---
 JsonExtensions/Http/HttpExtensions.cs        |   4 +-
 JsonExtensions/Writing/OptionalExtensions.cs | 108 +++++--------------
 2 files changed, 25 insertions(+), 87 deletions(-)

diff --git a/JsonExtensions/Http/HttpExtensions.cs b/JsonExtensions/Http/HttpExtensions.cs
index 064aff7..92c57fb 100644
--- a/JsonExtensions/Http/HttpExtensions.cs
+++ b/JsonExtensions/Http/HttpExtensions.cs
@@ -56,9 +56,7 @@ public async Task<JsonElement> GetJsonAsync(
             return await response.Content.ReadAsJsonAsync(cancellationToken).ConfigureAwait(false);
         }
 
-        /// <summary>
-        /// Sends a GET request to <paramref name="requestUri"/> and deserializes the response body as a <see cref="JsonElement"/>.
-        /// </summary>
+        /// <inheritdoc cref="GetJsonAsync(HttpClient, Uri, CancellationToken)"/>
         public async Task<JsonElement> GetJsonAsync(
             string requestUri,
             CancellationToken cancellationToken = default
diff --git a/JsonExtensions/Writing/OptionalExtensions.cs b/JsonExtensions/Writing/OptionalExtensions.cs
index df382ec..6d9a1b0 100644
--- a/JsonExtensions/Writing/OptionalExtensions.cs
+++ b/JsonExtensions/Writing/OptionalExtensions.cs
@@ -44,9 +44,7 @@ public void WriteNumberValue(byte? value)
                 writer.WriteNullValue();
         }
 
-        /// <summary>
-        /// Writes <paramref name="value"/> as a JSON number, or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteNumberValue(Utf8JsonWriter, byte?)"/>
         public void WriteNumberValue(decimal? value)
         {
             if (value is not null)
@@ -55,9 +53,7 @@ public void WriteNumberValue(decimal? value)
                 writer.WriteNullValue();
         }
 
-        /// <summary>
-        /// Writes <paramref name="value"/> as a JSON number, or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteNumberValue(Utf8JsonWriter, byte?)"/>
         public void WriteNumberValue(double? value)
         {
             if (value is not null)
@@ -66,9 +62,7 @@ public void WriteNumberValue(double? value)
                 writer.WriteNullValue();
         }
 
-        /// <summary>
-        /// Writes <paramref name="value"/> as a JSON number, or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteNumberValue(Utf8JsonWriter, byte?)"/>
         public void WriteNumberValue(float? value)
         {
             if (value is not null)
@@ -77,9 +71,7 @@ public void WriteNumberValue(float? value)
                 writer.WriteNullValue();
         }
 
-        /// <summary>
-        /// Writes <paramref name="value"/> as a JSON number, or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteNumberValue(Utf8JsonWriter, byte?)"/>
         public void WriteNumberValue(int? value)
         {
             if (value is not null)
@@ -88,9 +80,7 @@ public void WriteNumberValue(int? value)
                 writer.WriteNullValue();
         }
 
-        /// <summary>
-        /// Writes <paramref name="value"/> as a JSON number, or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteNumberValue(Utf8JsonWriter, byte?)"/>
         public void WriteNumberValue(long? value)
         {
             if (value is not null)
@@ -99,9 +89,7 @@ public void WriteNumberValue(long? value)
                 writer.WriteNullValue();
         }
 
-        /// <summary>
-        /// Writes <paramref name="value"/> as a JSON number, or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteNumberValue(Utf8JsonWriter, byte?)"/>
         public void WriteNumberValue(sbyte? value)
         {
             if (value is not null)
@@ -110,9 +98,7 @@ public void WriteNumberValue(sbyte? value)
                 writer.WriteNullValue();
         }
 
-        /// <summary>
-        /// Writes <paramref name="value"/> as a JSON number, or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteNumberValue(Utf8JsonWriter, byte?)"/>
         public void WriteNumberValue(short? value)
         {
             if (value is not null)
@@ -121,9 +107,7 @@ public void WriteNumberValue(short? value)
                 writer.WriteNullValue();
         }
 
-        /// <summary>
-        /// Writes <paramref name="value"/> as a JSON number, or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteNumberValue(Utf8JsonWriter, byte?)"/>
         public void WriteNumberValue(uint? value)
         {
             if (value is not null)
@@ -132,9 +116,7 @@ public void WriteNumberValue(uint? value)
                 writer.WriteNullValue();
         }
 
-        /// <summary>
-        /// Writes <paramref name="value"/> as a JSON number, or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteNumberValue(Utf8JsonWriter, byte?)"/>
         public void WriteNumberValue(ulong? value)
         {
             if (value is not null)
@@ -143,9 +125,7 @@ public void WriteNumberValue(ulong? value)
                 writer.WriteNullValue();
         }
 
-        /// <summary>
-        /// Writes <paramref name="value"/> as a JSON number, or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteNumberValue(Utf8JsonWriter, byte?)"/>
         public void WriteNumberValue(ushort? value)
         {
             if (value is not null)
@@ -164,100 +144,70 @@ public void WriteNumber(string propertyName, byte? value)
             writer.WriteNumberValue(value);
         }
 
-        /// <summary>
-        /// Writes a property named <paramref name="propertyName"/> with a numeric value,
-        /// or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteNumber(Utf8JsonWriter, string, byte?)"/>
         public void WriteNumber(string propertyName, decimal? value)
         {
             writer.WritePropertyName(propertyName);
             writer.WriteNumberValue(value);
         }
 
-        /// <summary>
-        /// Writes a property named <paramref name="propertyName"/> with a numeric value,
-        /// or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteNumber(Utf8JsonWriter, string, byte?)"/>
         public void WriteNumber(string propertyName, double? value)
         {
             writer.WritePropertyName(propertyName);
             writer.WriteNumberValue(value);
         }
 
-        /// <summary>
-        /// Writes a property named <paramref name="propertyName"/> with a numeric value,
-        /// or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteNumber(Utf8JsonWriter, string, byte?)"/>
         public void WriteNumber(string propertyName, float? value)
         {
             writer.WritePropertyName(propertyName);
             writer.WriteNumberValue(value);
         }
 
-        /// <summary>
-        /// Writes a property named <paramref name="propertyName"/> with a numeric value,
-        /// or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteNumber(Utf8JsonWriter, string, byte?)"/>
         public void WriteNumber(string propertyName, int? value)
         {
             writer.WritePropertyName(propertyName);
             writer.WriteNumberValue(value);
         }
 
-        /// <summary>
-        /// Writes a property named <paramref name="propertyName"/> with a numeric value,
-        /// or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteNumber(Utf8JsonWriter, string, byte?)"/>
         public void WriteNumber(string propertyName, long? value)
         {
             writer.WritePropertyName(propertyName);
             writer.WriteNumberValue(value);
         }
 
-        /// <summary>
-        /// Writes a property named <paramref name="propertyName"/> with a numeric value,
-        /// or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteNumber(Utf8JsonWriter, string, byte?)"/>
         public void WriteNumber(string propertyName, sbyte? value)
         {
             writer.WritePropertyName(propertyName);
             writer.WriteNumberValue(value);
         }
 
-        /// <summary>
-        /// Writes a property named <paramref name="propertyName"/> with a numeric value,
-        /// or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteNumber(Utf8JsonWriter, string, byte?)"/>
         public void WriteNumber(string propertyName, short? value)
         {
             writer.WritePropertyName(propertyName);
             writer.WriteNumberValue(value);
         }
 
-        /// <summary>
-        /// Writes a property named <paramref name="propertyName"/> with a numeric value,
-        /// or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteNumber(Utf8JsonWriter, string, byte?)"/>
         public void WriteNumber(string propertyName, uint? value)
         {
             writer.WritePropertyName(propertyName);
             writer.WriteNumberValue(value);
         }
 
-        /// <summary>
-        /// Writes a property named <paramref name="propertyName"/> with a numeric value,
-        /// or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteNumber(Utf8JsonWriter, string, byte?)"/>
         public void WriteNumber(string propertyName, ulong? value)
         {
             writer.WritePropertyName(propertyName);
             writer.WriteNumberValue(value);
         }
 
-        /// <summary>
-        /// Writes a property named <paramref name="propertyName"/> with a numeric value,
-        /// or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteNumber(Utf8JsonWriter, string, byte?)"/>
         public void WriteNumber(string propertyName, ushort? value)
         {
             writer.WritePropertyName(propertyName);
@@ -275,9 +225,7 @@ public void WriteStringValue(DateTime? value)
                 writer.WriteNullValue();
         }
 
-        /// <summary>
-        /// Writes <paramref name="value"/> as a JSON string, or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteStringValue(Utf8JsonWriter, DateTime?)"/>
         public void WriteStringValue(DateTimeOffset? value)
         {
             if (value is not null)
@@ -286,9 +234,7 @@ public void WriteStringValue(DateTimeOffset? value)
                 writer.WriteNullValue();
         }
 
-        /// <summary>
-        /// Writes <paramref name="value"/> as a JSON string, or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteStringValue(Utf8JsonWriter, DateTime?)"/>
         public void WriteStringValue(Guid? value)
         {
             if (value is not null)
@@ -307,20 +253,14 @@ public void WriteString(string propertyName, DateTime? value)
             writer.WriteStringValue(value);
         }
 
-        /// <summary>
-        /// Writes a property named <paramref name="propertyName"/> with a string value,
-        /// or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteString(Utf8JsonWriter, string, DateTime?)"/>
         public void WriteString(string propertyName, DateTimeOffset? value)
         {
             writer.WritePropertyName(propertyName);
             writer.WriteStringValue(value);
         }
 
-        /// <summary>
-        /// Writes a property named <paramref name="propertyName"/> with a string value,
-        /// or a JSON null if <paramref name="value"/> is null.
-        /// </summary>
+        /// <inheritdoc cref="WriteString(Utf8JsonWriter, string, DateTime?)"/>
         public void WriteString(string propertyName, Guid? value)
         {
             writer.WritePropertyName(propertyName);

From b33d7f06d390e8d1204f4b6cf8708e55c2c5403a Mon Sep 17 00:00:00 2001
From: Oleksii Holub <1935960+Tyrrrz@users.noreply.github.com>
Date: Tue, 28 Jul 2026 10:58:29 +0300
Subject: [PATCH 2/3] Potential fix for pull request finding

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
---
 JsonExtensions/Writing/OptionalExtensions.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/JsonExtensions/Writing/OptionalExtensions.cs b/JsonExtensions/Writing/OptionalExtensions.cs
index 6d9a1b0..eb2ac4b 100644
--- a/JsonExtensions/Writing/OptionalExtensions.cs
+++ b/JsonExtensions/Writing/OptionalExtensions.cs
@@ -44,7 +44,7 @@ public void WriteNumberValue(byte? value)
                 writer.WriteNullValue();
         }
 
-        /// <inheritdoc cref="WriteNumberValue(Utf8JsonWriter, byte?)"/>
+        /// <inheritdoc cref="WriteNumberValue(Utf8JsonWriter, byte?)" />
         public void WriteNumberValue(decimal? value)
         {
             if (value is not null)

From c4af825efc2b3dd3290193cf7440bcde2c55aedb Mon Sep 17 00:00:00 2001
From: Oleksii Holub <1935960+Tyrrrz@users.noreply.github.com>
Date: Tue, 28 Jul 2026 10:58:47 +0300
Subject: [PATCH 3/3] Potential fix for pull request finding

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
---
 JsonExtensions/Http/HttpExtensions.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/JsonExtensions/Http/HttpExtensions.cs b/JsonExtensions/Http/HttpExtensions.cs
index 92c57fb..f21aede 100644
--- a/JsonExtensions/Http/HttpExtensions.cs
+++ b/JsonExtensions/Http/HttpExtensions.cs
@@ -56,7 +56,7 @@ public async Task<JsonElement> GetJsonAsync(
             return await response.Content.ReadAsJsonAsync(cancellationToken).ConfigureAwait(false);
         }
 
-        /// <inheritdoc cref="GetJsonAsync(HttpClient, Uri, CancellationToken)"/>
+        /// <inheritdoc cref="GetJsonAsync(HttpClient, Uri, CancellationToken)" />
         public async Task<JsonElement> GetJsonAsync(
             string requestUri,
             CancellationToken cancellationToken = default