Return schema proxy reference if reference pointer exists

Author: MaggieKimani1

src/Microsoft.OpenApi/Models/References/OpenApiSchemaReference.cs

@@ -1,4 +1,4 @@
-// Copyright (c) Microsoft Corporation. All rights reserved.
+// Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT license.
 
 using Microsoft.OpenApi.Any;
@@ -100,7 +100,11 @@ internal OpenApiSchemaReference(OpenApiSchema target, string referenceId)
         /// <inheritdoc/>
         public override string Format { get => Target.Format; set => Target.Format = value; }
         /// <inheritdoc/>
-        public override string Description { get => Target.Description; set => Target.Description = value; }
+        public override string Description
+        {
+            get => string.IsNullOrEmpty(_description) ? Target.Description : _description;
+            set => _description = value;
+        }
         /// <inheritdoc/>
         public override decimal? Maximum { get => Target.Maximum; set => Target.Maximum = value; }
         /// <inheritdoc/>

src/Microsoft.OpenApi/Reader/V2/OpenApiSchemaDeserializer.cs

@@ -6,6 +6,7 @@
 using Microsoft.OpenApi.Models;
 using Microsoft.OpenApi.Extensions;
 using Microsoft.OpenApi.Reader.ParseNodes;
+using Microsoft.OpenApi.Models.References;
 
 namespace Microsoft.OpenApi.Reader.V2
 {
@@ -162,7 +163,8 @@ public static OpenApiSchema LoadSchema(ParseNode node, OpenApiDocument hostDocum
             var pointer = mapNode.GetReferencePointer();
             if (pointer != null)
             {
-                return mapNode.GetReferencedObject<OpenApiSchema>(ReferenceType.Schema, pointer);
+                var reference = GetReferenceIdAndExternalResource(pointer);
+                return new OpenApiSchemaReference(reference.Item1, hostDocument, reference.Item2);
             }
 
             var schema = new OpenApiSchema();

src/Microsoft.OpenApi/Reader/V3/OpenApiSchemaDeserializer.cs

@@ -3,6 +3,7 @@
 
 using Microsoft.OpenApi.Extensions;
 using Microsoft.OpenApi.Models;
+using Microsoft.OpenApi.Models.References;
 using Microsoft.OpenApi.Reader.ParseNodes;
 using System.Collections.Generic;
 using System.Globalization;
@@ -181,11 +182,8 @@ public static OpenApiSchema LoadSchema(ParseNode node, OpenApiDocument hostDocum
 
             if (pointer != null)
             {
-                return new()
-                {
-                    UnresolvedReference = true,
-                    Reference = node.Context.VersionService.ConvertToOpenApiReference(pointer, ReferenceType.Schema)
-                };
+                var reference = GetReferenceIdAndExternalResource(pointer);
+                return new OpenApiSchemaReference(reference.Item1, hostDocument, reference.Item2);
             }
 
             var schema = new OpenApiSchema();

src/Microsoft.OpenApi/Reader/V31/OpenApiSchemaDeserializer.cs

@@ -3,6 +3,7 @@
 
 using Microsoft.OpenApi.Extensions;
 using Microsoft.OpenApi.Models;
+using Microsoft.OpenApi.Models.References;
 using Microsoft.OpenApi.Reader.ParseNodes;
 using System.Collections.Generic;
 using System.Globalization;
@@ -230,11 +231,8 @@ public static OpenApiSchema LoadSchema(ParseNode node, OpenApiDocument hostDocum
 
             if (pointer != null)
             {
-                return new()
-                {
-                    UnresolvedReference = true,
-                    Reference = node.Context.VersionService.ConvertToOpenApiReference(pointer, ReferenceType.Schema)
-                };
+                var reference = GetReferenceIdAndExternalResource(pointer);
+                return new OpenApiSchemaReference(reference.Item1, hostDocument, reference.Item2);
             }
 
             var schema = new OpenApiSchema();