Fix null assignment warning

desjoerd · desjoerd · commit d781b573fda7 · 2025-08-05T18:36:13.000+02:00
diff --git a/src/OpenApi/gen/XmlCommentGenerator.Emitter.cs b/src/OpenApi/gen/XmlCommentGenerator.Emitter.cs
@@ -464,12 +464,13 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext
                 // Apply comments from the property
                 if (XmlCommentCache.Cache.TryGetValue(DocumentationCommentIdHelper.NormalizeDocId(propertyInfo.CreateDocumentationId()), out var propertyComment))
                 {
-                    if(schema.Metadata is null
+                    var isInlinedSchema = schema.Metadata is null
                         || !schema.Metadata.TryGetValue("x-schema-id", out var schemaId)
-                        || string.IsNullOrEmpty(schemaId as string))
+                        || string.IsNullOrEmpty(schemaId as string);
+                    if(isInlinedSchema)
                     {
                         // Inlined schema
-                        schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;
+                        schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;
                         if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)
                         {
                             schema.Example = jsonString.Parse();
@@ -478,7 +479,7 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext
                     else
                     {
                         // Schema Reference
-                        schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;
+                        schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;
                         if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)
                         {
                             schema.Metadata["x-ref-example"] = jsonString.Parse();
diff --git a/src/OpenApi/src/Services/Schemas/OpenApiSchemaService.cs b/src/OpenApi/src/Services/Schemas/OpenApiSchemaService.cs
@@ -101,7 +101,8 @@ internal sealed class OpenApiSchemaService(
             {
                 schema.ApplyNullabilityContextInfo(jsonPropertyInfo);
             }
-            if (context.PropertyInfo is { AttributeProvider: { } attributeProvider })
+            var isInlinedSchema = schema["x-schema-id"] is null;
+            if (isInlinedSchema && context.PropertyInfo is { AttributeProvider: { } attributeProvider })
             {
                 if (attributeProvider.GetCustomAttributes(inherit: false).OfType<ValidationAttribute>() is { } validationAttributes)
                 {
diff --git a/src/OpenApi/test/Microsoft.AspNetCore.OpenApi.SourceGenerators.Tests/snapshots/AddOpenApiTests.CanInterceptAddOpenApi#OpenApiXmlCommentSupport.generated.verified.cs b/src/OpenApi/test/Microsoft.AspNetCore.OpenApi.SourceGenerators.Tests/snapshots/AddOpenApiTests.CanInterceptAddOpenApi#OpenApiXmlCommentSupport.generated.verified.cs
@@ -446,12 +446,13 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext
                 // Apply comments from the property
                 if (XmlCommentCache.Cache.TryGetValue(DocumentationCommentIdHelper.NormalizeDocId(propertyInfo.CreateDocumentationId()), out var propertyComment))
                 {
-                    if(schema.Metadata is null
+                    var isInlinedSchema = schema.Metadata is null
                         || !schema.Metadata.TryGetValue("x-schema-id", out var schemaId)
-                        || string.IsNullOrEmpty(schemaId as string))
+                        || string.IsNullOrEmpty(schemaId as string);
+                    if(isInlinedSchema)
                     {
                         // Inlined schema
-                        schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;
+                        schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;
                         if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)
                         {
                             schema.Example = jsonString.Parse();
@@ -460,7 +461,7 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext
                     else
                     {
                         // Schema Reference
-                        schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;
+                        schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;
                         if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)
                         {
                             schema.Metadata["x-ref-example"] = jsonString.Parse();
diff --git a/src/OpenApi/test/Microsoft.AspNetCore.OpenApi.SourceGenerators.Tests/snapshots/AdditionalTextsTests.CanHandleXmlForSchemasInAdditionalTexts#OpenApiXmlCommentSupport.generated.verified.cs b/src/OpenApi/test/Microsoft.AspNetCore.OpenApi.SourceGenerators.Tests/snapshots/AdditionalTextsTests.CanHandleXmlForSchemasInAdditionalTexts#OpenApiXmlCommentSupport.generated.verified.cs
@@ -475,12 +475,13 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext
                 // Apply comments from the property
                 if (XmlCommentCache.Cache.TryGetValue(DocumentationCommentIdHelper.NormalizeDocId(propertyInfo.CreateDocumentationId()), out var propertyComment))
                 {
-                    if(schema.Metadata is null
+                    var isInlinedSchema = schema.Metadata is null
                         || !schema.Metadata.TryGetValue("x-schema-id", out var schemaId)
-                        || string.IsNullOrEmpty(schemaId as string))
+                        || string.IsNullOrEmpty(schemaId as string);
+                    if(isInlinedSchema)
                     {
                         // Inlined schema
-                        schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;
+                        schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;
                         if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)
                         {
                             schema.Example = jsonString.Parse();
@@ -489,7 +490,7 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext
                     else
                     {
                         // Schema Reference
-                        schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;
+                        schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;
                         if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)
                         {
                             schema.Metadata["x-ref-example"] = jsonString.Parse();
diff --git a/src/OpenApi/test/Microsoft.AspNetCore.OpenApi.SourceGenerators.Tests/snapshots/CompletenessTests.SupportsAllXmlTagsOnSchemas#OpenApiXmlCommentSupport.generated.verified.cs b/src/OpenApi/test/Microsoft.AspNetCore.OpenApi.SourceGenerators.Tests/snapshots/CompletenessTests.SupportsAllXmlTagsOnSchemas#OpenApiXmlCommentSupport.generated.verified.cs
@@ -567,12 +567,13 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext
                 // Apply comments from the property
                 if (XmlCommentCache.Cache.TryGetValue(DocumentationCommentIdHelper.NormalizeDocId(propertyInfo.CreateDocumentationId()), out var propertyComment))
                 {
-                    if(schema.Metadata is null
+                    var isInlinedSchema = schema.Metadata is null
                         || !schema.Metadata.TryGetValue("x-schema-id", out var schemaId)
-                        || string.IsNullOrEmpty(schemaId as string))
+                        || string.IsNullOrEmpty(schemaId as string);
+                    if(isInlinedSchema)
                     {
                         // Inlined schema
-                        schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;
+                        schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;
                         if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)
                         {
                             schema.Example = jsonString.Parse();
@@ -581,7 +582,7 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext
                     else
                     {
                         // Schema Reference
-                        schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;
+                        schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;
                         if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)
                         {
                             schema.Metadata["x-ref-example"] = jsonString.Parse();
diff --git a/src/OpenApi/test/Microsoft.AspNetCore.OpenApi.SourceGenerators.Tests/snapshots/OperationTests.SupportsXmlCommentsOnOperationsFromControllers#OpenApiXmlCommentSupport.generated.verified.cs b/src/OpenApi/test/Microsoft.AspNetCore.OpenApi.SourceGenerators.Tests/snapshots/OperationTests.SupportsXmlCommentsOnOperationsFromControllers#OpenApiXmlCommentSupport.generated.verified.cs
@@ -450,12 +450,13 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext
                 // Apply comments from the property
                 if (XmlCommentCache.Cache.TryGetValue(DocumentationCommentIdHelper.NormalizeDocId(propertyInfo.CreateDocumentationId()), out var propertyComment))
                 {
-                    if(schema.Metadata is null
+                    var isInlinedSchema = schema.Metadata is null
                         || !schema.Metadata.TryGetValue("x-schema-id", out var schemaId)
-                        || string.IsNullOrEmpty(schemaId as string))
+                        || string.IsNullOrEmpty(schemaId as string);
+                    if(isInlinedSchema)
                     {
                         // Inlined schema
-                        schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;
+                        schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;
                         if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)
                         {
                             schema.Example = jsonString.Parse();
@@ -464,7 +465,7 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext
                     else
                     {
                         // Schema Reference
-                        schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;
+                        schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;
                         if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)
                         {
                             schema.Metadata["x-ref-example"] = jsonString.Parse();
diff --git a/src/OpenApi/test/Microsoft.AspNetCore.OpenApi.SourceGenerators.Tests/snapshots/OperationTests.SupportsXmlCommentsOnOperationsFromMinimalApis#OpenApiXmlCommentSupport.generated.verified.cs b/src/OpenApi/test/Microsoft.AspNetCore.OpenApi.SourceGenerators.Tests/snapshots/OperationTests.SupportsXmlCommentsOnOperationsFromMinimalApis#OpenApiXmlCommentSupport.generated.verified.cs
@@ -468,12 +468,13 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext
                 // Apply comments from the property
                 if (XmlCommentCache.Cache.TryGetValue(DocumentationCommentIdHelper.NormalizeDocId(propertyInfo.CreateDocumentationId()), out var propertyComment))
                 {
-                    if(schema.Metadata is null
+                    var isInlinedSchema = schema.Metadata is null
                         || !schema.Metadata.TryGetValue("x-schema-id", out var schemaId)
-                        || string.IsNullOrEmpty(schemaId as string))
+                        || string.IsNullOrEmpty(schemaId as string);
+                    if(isInlinedSchema)
                     {
                         // Inlined schema
-                        schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;
+                        schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;
                         if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)
                         {
                             schema.Example = jsonString.Parse();
@@ -482,7 +483,7 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext
                     else
                     {
                         // Schema Reference
-                        schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;
+                        schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;
                         if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)
                         {
                             schema.Metadata["x-ref-example"] = jsonString.Parse();
diff --git a/src/OpenApi/test/Microsoft.AspNetCore.OpenApi.SourceGenerators.Tests/snapshots/SchemaTests.SupportsXmlCommentsOnSchemas#OpenApiXmlCommentSupport.generated.verified.cs b/src/OpenApi/test/Microsoft.AspNetCore.OpenApi.SourceGenerators.Tests/snapshots/SchemaTests.SupportsXmlCommentsOnSchemas#OpenApiXmlCommentSupport.generated.verified.cs
@@ -476,12 +476,13 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext
                 // Apply comments from the property
                 if (XmlCommentCache.Cache.TryGetValue(DocumentationCommentIdHelper.NormalizeDocId(propertyInfo.CreateDocumentationId()), out var propertyComment))
                 {
-                    if(schema.Metadata is null
+                    var isInlinedSchema = schema.Metadata is null
                         || !schema.Metadata.TryGetValue("x-schema-id", out var schemaId)
-                        || string.IsNullOrEmpty(schemaId as string))
+                        || string.IsNullOrEmpty(schemaId as string);
+                    if(isInlinedSchema)
                     {
                         // Inlined schema
-                        schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;
+                        schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;
                         if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)
                         {
                             schema.Example = jsonString.Parse();
@@ -490,7 +491,7 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext
                     else
                     {
                         // Schema Reference
-                        schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;
+                        schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;
                         if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)
                         {
                             schema.Metadata["x-ref-example"] = jsonString.Parse();
diff --git a/src/OpenApi/test/Microsoft.AspNetCore.OpenApi.SourceGenerators.Tests/snapshots/SchemaTests.XmlCommentsOnPropertiesShouldApplyToSchemaReferences#OpenApiXmlCommentSupport.generated.verified.cs b/src/OpenApi/test/Microsoft.AspNetCore.OpenApi.SourceGenerators.Tests/snapshots/SchemaTests.XmlCommentsOnPropertiesShouldApplyToSchemaReferences#OpenApiXmlCommentSupport.generated.verified.cs
@@ -455,12 +455,13 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext
                 // Apply comments from the property
                 if (XmlCommentCache.Cache.TryGetValue(DocumentationCommentIdHelper.NormalizeDocId(propertyInfo.CreateDocumentationId()), out var propertyComment))
                 {
-                    if(schema.Metadata is null
+                    var isInlinedSchema = schema.Metadata is null
                         || !schema.Metadata.TryGetValue("x-schema-id", out var schemaId)
-                        || string.IsNullOrEmpty(schemaId as string))
+                        || string.IsNullOrEmpty(schemaId as string);
+                    if(isInlinedSchema)
                     {
                         // Inlined schema
-                        schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;
+                        schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;
                         if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)
                         {
                             schema.Example = jsonString.Parse();
@@ -469,7 +470,7 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext
                     else
                     {
                         // Schema Reference
-                        schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;
+                        schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;
                         if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)
                         {
                             schema.Metadata["x-ref-example"] = jsonString.Parse();
diff --git a/src/OpenApi/test/Microsoft.AspNetCore.OpenApi.SourceGenerators.Tests/snapshots/XmlCommentDocumentationIdTests.CanMergeXmlCommentsWithDifferentDocumentationIdFormats#OpenApiXmlCommentSupport.generated.verified.cs b/src/OpenApi/test/Microsoft.AspNetCore.OpenApi.SourceGenerators.Tests/snapshots/XmlCommentDocumentationIdTests.CanMergeXmlCommentsWithDifferentDocumentationIdFormats#OpenApiXmlCommentSupport.generated.verified.cs
@@ -447,12 +447,13 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext
                 // Apply comments from the property
                 if (XmlCommentCache.Cache.TryGetValue(DocumentationCommentIdHelper.NormalizeDocId(propertyInfo.CreateDocumentationId()), out var propertyComment))
                 {
-                    if(schema.Metadata is null
+                    var isInlinedSchema = schema.Metadata is null
                         || !schema.Metadata.TryGetValue("x-schema-id", out var schemaId)
-                        || string.IsNullOrEmpty(schemaId as string))
+                        || string.IsNullOrEmpty(schemaId as string);
+                    if(isInlinedSchema)
                     {
                         // Inlined schema
-                        schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;
+                        schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;
                         if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)
                         {
                             schema.Example = jsonString.Parse();
@@ -461,7 +462,7 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext
                     else
                     {
                         // Schema Reference
-                        schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;
+                        schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;
                         if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)
                         {
                             schema.Metadata["x-ref-example"] = jsonString.Parse();

Original file line number	Diff line number	Diff line change
`@@ -464,12 +464,13 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext`
`464`	`464`	`// Apply comments from the property`
`465`	`465`	`if (XmlCommentCache.Cache.TryGetValue(DocumentationCommentIdHelper.NormalizeDocId(propertyInfo.CreateDocumentationId()), out var propertyComment))`
`466`	`466`	`{`
`467`		`- if(schema.Metadata is null`
	`467`	`+ var isInlinedSchema = schema.Metadata is null`
`468`	`468`	`\|\| !schema.Metadata.TryGetValue("x-schema-id", out var schemaId)`
`469`		`- \|\| string.IsNullOrEmpty(schemaId as string))`
	`469`	`+ \|\| string.IsNullOrEmpty(schemaId as string);`
	`470`	`+ if(isInlinedSchema)`
`470`	`471`	`{`
`471`	`472`	`// Inlined schema`
`472`		`- schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;`
	`473`	`+ schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;`
`473`	`474`	`if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)`
`474`	`475`	`{`
`475`	`476`	`schema.Example = jsonString.Parse();`
`@@ -478,7 +479,7 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext`
`478`	`479`	`else`
`479`	`480`	`{`
`480`	`481`	`// Schema Reference`
`481`		`- schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;`
	`482`	`+ schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;`
`482`	`483`	`if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)`
`483`	`484`	`{`
`484`	`485`	`schema.Metadata["x-ref-example"] = jsonString.Parse();`
Original file line number	Diff line number	Diff line change
`@@ -101,7 +101,8 @@ internal sealed class OpenApiSchemaService(`
`101`	`101`	`{`
`102`	`102`	`schema.ApplyNullabilityContextInfo(jsonPropertyInfo);`
`103`	`103`	`}`
`104`		`- if (context.PropertyInfo is { AttributeProvider: { } attributeProvider })`
	`104`	`+ var isInlinedSchema = schema["x-schema-id"] is null;`
	`105`	`+ if (isInlinedSchema && context.PropertyInfo is { AttributeProvider: { } attributeProvider })`
`105`	`106`	`{`
`106`	`107`	`if (attributeProvider.GetCustomAttributes(inherit: false).OfType<ValidationAttribute>() is { } validationAttributes)`
`107`	`108`	`{`
Original file line number	Diff line number	Diff line change
`@@ -446,12 +446,13 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext`
`446`	`446`	`// Apply comments from the property`
`447`	`447`	`if (XmlCommentCache.Cache.TryGetValue(DocumentationCommentIdHelper.NormalizeDocId(propertyInfo.CreateDocumentationId()), out var propertyComment))`
`448`	`448`	`{`
`449`		`- if(schema.Metadata is null`
	`449`	`+ var isInlinedSchema = schema.Metadata is null`
`450`	`450`	`\|\| !schema.Metadata.TryGetValue("x-schema-id", out var schemaId)`
`451`		`- \|\| string.IsNullOrEmpty(schemaId as string))`
	`451`	`+ \|\| string.IsNullOrEmpty(schemaId as string);`
	`452`	`+ if(isInlinedSchema)`
`452`	`453`	`{`
`453`	`454`	`// Inlined schema`
`454`		`- schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;`
	`455`	`+ schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;`
`455`	`456`	`if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)`
`456`	`457`	`{`
`457`	`458`	`schema.Example = jsonString.Parse();`
`@@ -460,7 +461,7 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext`
`460`	`461`	`else`
`461`	`462`	`{`
`462`	`463`	`// Schema Reference`
`463`		`- schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;`
	`464`	`+ schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;`
`464`	`465`	`if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)`
`465`	`466`	`{`
`466`	`467`	`schema.Metadata["x-ref-example"] = jsonString.Parse();`
Original file line number	Diff line number	Diff line change
`@@ -475,12 +475,13 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext`
`475`	`475`	`// Apply comments from the property`
`476`	`476`	`if (XmlCommentCache.Cache.TryGetValue(DocumentationCommentIdHelper.NormalizeDocId(propertyInfo.CreateDocumentationId()), out var propertyComment))`
`477`	`477`	`{`
`478`		`- if(schema.Metadata is null`
	`478`	`+ var isInlinedSchema = schema.Metadata is null`
`479`	`479`	`\|\| !schema.Metadata.TryGetValue("x-schema-id", out var schemaId)`
`480`		`- \|\| string.IsNullOrEmpty(schemaId as string))`
	`480`	`+ \|\| string.IsNullOrEmpty(schemaId as string);`
	`481`	`+ if(isInlinedSchema)`
`481`	`482`	`{`
`482`	`483`	`// Inlined schema`
`483`		`- schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;`
	`484`	`+ schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;`
`484`	`485`	`if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)`
`485`	`486`	`{`
`486`	`487`	`schema.Example = jsonString.Parse();`
`@@ -489,7 +490,7 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext`
`489`	`490`	`else`
`490`	`491`	`{`
`491`	`492`	`// Schema Reference`
`492`		`- schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;`
	`493`	`+ schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;`
`493`	`494`	`if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)`
`494`	`495`	`{`
`495`	`496`	`schema.Metadata["x-ref-example"] = jsonString.Parse();`
Original file line number	Diff line number	Diff line change
`@@ -567,12 +567,13 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext`
`567`	`567`	`// Apply comments from the property`
`568`	`568`	`if (XmlCommentCache.Cache.TryGetValue(DocumentationCommentIdHelper.NormalizeDocId(propertyInfo.CreateDocumentationId()), out var propertyComment))`
`569`	`569`	`{`
`570`		`- if(schema.Metadata is null`
	`570`	`+ var isInlinedSchema = schema.Metadata is null`
`571`	`571`	`\|\| !schema.Metadata.TryGetValue("x-schema-id", out var schemaId)`
`572`		`- \|\| string.IsNullOrEmpty(schemaId as string))`
	`572`	`+ \|\| string.IsNullOrEmpty(schemaId as string);`
	`573`	`+ if(isInlinedSchema)`
`573`	`574`	`{`
`574`	`575`	`// Inlined schema`
`575`		`- schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;`
	`576`	`+ schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;`
`576`	`577`	`if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)`
`577`	`578`	`{`
`578`	`579`	`schema.Example = jsonString.Parse();`
`@@ -581,7 +582,7 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext`
`581`	`582`	`else`
`582`	`583`	`{`
`583`	`584`	`// Schema Reference`
`584`		`- schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;`
	`585`	`+ schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;`
`585`	`586`	`if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)`
`586`	`587`	`{`
`587`	`588`	`schema.Metadata["x-ref-example"] = jsonString.Parse();`
Original file line number	Diff line number	Diff line change
`@@ -450,12 +450,13 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext`
`450`	`450`	`// Apply comments from the property`
`451`	`451`	`if (XmlCommentCache.Cache.TryGetValue(DocumentationCommentIdHelper.NormalizeDocId(propertyInfo.CreateDocumentationId()), out var propertyComment))`
`452`	`452`	`{`
`453`		`- if(schema.Metadata is null`
	`453`	`+ var isInlinedSchema = schema.Metadata is null`
`454`	`454`	`\|\| !schema.Metadata.TryGetValue("x-schema-id", out var schemaId)`
`455`		`- \|\| string.IsNullOrEmpty(schemaId as string))`
	`455`	`+ \|\| string.IsNullOrEmpty(schemaId as string);`
	`456`	`+ if(isInlinedSchema)`
`456`	`457`	`{`
`457`	`458`	`// Inlined schema`
`458`		`- schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;`
	`459`	`+ schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;`
`459`	`460`	`if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)`
`460`	`461`	`{`
`461`	`462`	`schema.Example = jsonString.Parse();`
`@@ -464,7 +465,7 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext`
`464`	`465`	`else`
`465`	`466`	`{`
`466`	`467`	`// Schema Reference`
`467`		`- schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;`
	`468`	`+ schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;`
`468`	`469`	`if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)`
`469`	`470`	`{`
`470`	`471`	`schema.Metadata["x-ref-example"] = jsonString.Parse();`
Original file line number	Diff line number	Diff line change
`@@ -468,12 +468,13 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext`
`468`	`468`	`// Apply comments from the property`
`469`	`469`	`if (XmlCommentCache.Cache.TryGetValue(DocumentationCommentIdHelper.NormalizeDocId(propertyInfo.CreateDocumentationId()), out var propertyComment))`
`470`	`470`	`{`
`471`		`- if(schema.Metadata is null`
	`471`	`+ var isInlinedSchema = schema.Metadata is null`
`472`	`472`	`\|\| !schema.Metadata.TryGetValue("x-schema-id", out var schemaId)`
`473`		`- \|\| string.IsNullOrEmpty(schemaId as string))`
	`473`	`+ \|\| string.IsNullOrEmpty(schemaId as string);`
	`474`	`+ if(isInlinedSchema)`
`474`	`475`	`{`
`475`	`476`	`// Inlined schema`
`476`		`- schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;`
	`477`	`+ schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;`
`477`	`478`	`if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)`
`478`	`479`	`{`
`479`	`480`	`schema.Example = jsonString.Parse();`
`@@ -482,7 +483,7 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext`
`482`	`483`	`else`
`483`	`484`	`{`
`484`	`485`	`// Schema Reference`
`485`		`- schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;`
	`486`	`+ schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;`
`486`	`487`	`if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)`
`487`	`488`	`{`
`488`	`489`	`schema.Metadata["x-ref-example"] = jsonString.Parse();`
Original file line number	Diff line number	Diff line change
`@@ -476,12 +476,13 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext`
`476`	`476`	`// Apply comments from the property`
`477`	`477`	`if (XmlCommentCache.Cache.TryGetValue(DocumentationCommentIdHelper.NormalizeDocId(propertyInfo.CreateDocumentationId()), out var propertyComment))`
`478`	`478`	`{`
`479`		`- if(schema.Metadata is null`
	`479`	`+ var isInlinedSchema = schema.Metadata is null`
`480`	`480`	`\|\| !schema.Metadata.TryGetValue("x-schema-id", out var schemaId)`
`481`		`- \|\| string.IsNullOrEmpty(schemaId as string))`
	`481`	`+ \|\| string.IsNullOrEmpty(schemaId as string);`
	`482`	`+ if(isInlinedSchema)`
`482`	`483`	`{`
`483`	`484`	`// Inlined schema`
`484`		`- schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;`
	`485`	`+ schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;`
`485`	`486`	`if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)`
`486`	`487`	`{`
`487`	`488`	`schema.Example = jsonString.Parse();`
`@@ -490,7 +491,7 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext`
`490`	`491`	`else`
`491`	`492`	`{`
`492`	`493`	`// Schema Reference`
`493`		`- schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;`
	`494`	`+ schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;`
`494`	`495`	`if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)`
`495`	`496`	`{`
`496`	`497`	`schema.Metadata["x-ref-example"] = jsonString.Parse();`
Original file line number	Diff line number	Diff line change
`@@ -455,12 +455,13 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext`
`455`	`455`	`// Apply comments from the property`
`456`	`456`	`if (XmlCommentCache.Cache.TryGetValue(DocumentationCommentIdHelper.NormalizeDocId(propertyInfo.CreateDocumentationId()), out var propertyComment))`
`457`	`457`	`{`
`458`		`- if(schema.Metadata is null`
	`458`	`+ var isInlinedSchema = schema.Metadata is null`
`459`	`459`	`\|\| !schema.Metadata.TryGetValue("x-schema-id", out var schemaId)`
`460`		`- \|\| string.IsNullOrEmpty(schemaId as string))`
	`460`	`+ \|\| string.IsNullOrEmpty(schemaId as string);`
	`461`	`+ if(isInlinedSchema)`
`461`	`462`	`{`
`462`	`463`	`// Inlined schema`
`463`		`- schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;`
	`464`	`+ schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;`
`464`	`465`	`if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)`
`465`	`466`	`{`
`466`	`467`	`schema.Example = jsonString.Parse();`
`@@ -469,7 +470,7 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext`
`469`	`470`	`else`
`470`	`471`	`{`
`471`	`472`	`// Schema Reference`
`472`		`- schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;`
	`473`	`+ schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;`
`473`	`474`	`if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)`
`474`	`475`	`{`
`475`	`476`	`schema.Metadata["x-ref-example"] = jsonString.Parse();`
Original file line number	Diff line number	Diff line change
`@@ -447,12 +447,13 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext`
`447`	`447`	`// Apply comments from the property`
`448`	`448`	`if (XmlCommentCache.Cache.TryGetValue(DocumentationCommentIdHelper.NormalizeDocId(propertyInfo.CreateDocumentationId()), out var propertyComment))`
`449`	`449`	`{`
`450`		`- if(schema.Metadata is null`
	`450`	`+ var isInlinedSchema = schema.Metadata is null`
`451`	`451`	`\|\| !schema.Metadata.TryGetValue("x-schema-id", out var schemaId)`
`452`		`- \|\| string.IsNullOrEmpty(schemaId as string))`
	`452`	`+ \|\| string.IsNullOrEmpty(schemaId as string);`
	`453`	`+ if(isInlinedSchema)`
`453`	`454`	`{`
`454`	`455`	`// Inlined schema`
`455`		`- schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;`
	`456`	`+ schema.Description = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;`
`456`	`457`	`if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)`
`457`	`458`	`{`
`458`	`459`	`schema.Example = jsonString.Parse();`
`@@ -461,7 +462,7 @@ public Task TransformAsync(OpenApiSchema schema, OpenApiSchemaTransformerContext`
`461`	`462`	`else`
`462`	`463`	`{`
`463`	`464`	`// Schema Reference`
`464`		`- schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary;`
	`465`	`+ schema.Metadata["x-ref-description"] = propertyComment.Value ?? propertyComment.Returns ?? propertyComment.Summary!;`
`465`	`466`	`if (propertyComment.Examples?.FirstOrDefault() is { } jsonString)`
`466`	`467`	`{`
`467`	`468`	`schema.Metadata["x-ref-example"] = jsonString.Parse();`