From 7e040bcdec5e5a60eac0cb8585d0065e4e7281ce Mon Sep 17 00:00:00 2001
From: Vincent Biret <vibiret@microsoft.com>
Date: Tue, 14 Jul 2026 12:38:40 -0400
Subject: [PATCH] docs: adds a mention of the shallow copy

Signed-off-by: Vincent Biret <vibiret@microsoft.com>
---
 src/Microsoft.OpenApi/Models/OpenApiPaths.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/Microsoft.OpenApi/Models/OpenApiPaths.cs b/src/Microsoft.OpenApi/Models/OpenApiPaths.cs
index 18e67c313..1aa163e3c 100644
--- a/src/Microsoft.OpenApi/Models/OpenApiPaths.cs
+++ b/src/Microsoft.OpenApi/Models/OpenApiPaths.cs
@@ -17,6 +17,9 @@ public OpenApiPaths() { }
         /// Initializes a copy of <see cref="OpenApiPaths"/> object
         /// </summary>
         /// <param name="paths">The <see cref="OpenApiPaths"/>.</param>
+        /// <remarks>
+        /// This creates a shallow copy, the path items are the same reference as in the provided parameter.
+        /// </remarks>
         public OpenApiPaths(OpenApiPaths paths) : base(dictionary: paths) { }
     }
 }