From 84496be89989c77a6f32f62d38b50c7fc6d13b9d Mon Sep 17 00:00:00 2001
From: Boss Kevin <kevin.boss@kms-ag.ch>
Date: Tue, 30 Sep 2025 11:29:31 +0200
Subject: [PATCH] Add XML documentation for default instance properties in
 complex value objects

---
 .../ValueObjects/ComplexValueObjectCodeGenerator.cs            | 3 +++
 ...uct_with_custom_default_instance_property_name.verified.txt | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/src/Thinktecture.Runtime.Extensions.SourceGenerator/CodeAnalysis/ValueObjects/ComplexValueObjectCodeGenerator.cs b/src/Thinktecture.Runtime.Extensions.SourceGenerator/CodeAnalysis/ValueObjects/ComplexValueObjectCodeGenerator.cs
index f1f32b62..3d92709f 100644
--- a/src/Thinktecture.Runtime.Extensions.SourceGenerator/CodeAnalysis/ValueObjects/ComplexValueObjectCodeGenerator.cs
+++ b/src/Thinktecture.Runtime.Extensions.SourceGenerator/CodeAnalysis/ValueObjects/ComplexValueObjectCodeGenerator.cs
@@ -85,6 +85,9 @@ private void GenerateValueObject(CancellationToken cancellationToken)
       {
          _sb.Append(@"
 
+      /// <summary>
+      /// Default instance of ").AppendTypeForXmlComment(_state).Append(@".
+      /// </summary>
       public static readonly ").AppendTypeFullyQualified(_state).Append(" ").Append(_state.Settings.DefaultInstancePropertyName).Append(" = default;");
       }
 
diff --git a/test/Thinktecture.Runtime.Extensions.SourceGenerator.Tests/SourceGeneratorTests/ValueObjectSourceGeneratorTests.Should_generate_complex_struct_with_custom_default_instance_property_name.verified.txt b/test/Thinktecture.Runtime.Extensions.SourceGenerator.Tests/SourceGeneratorTests/ValueObjectSourceGeneratorTests.Should_generate_complex_struct_with_custom_default_instance_property_name.verified.txt
index 097eb1ea..677e6de4 100644
--- a/test/Thinktecture.Runtime.Extensions.SourceGenerator.Tests/SourceGeneratorTests/ValueObjectSourceGeneratorTests.Should_generate_complex_struct_with_custom_default_instance_property_name.verified.txt
+++ b/test/Thinktecture.Runtime.Extensions.SourceGenerator.Tests/SourceGeneratorTests/ValueObjectSourceGeneratorTests.Should_generate_complex_struct_with_custom_default_instance_property_name.verified.txt
@@ -25,6 +25,9 @@ namespace Thinktecture.Tests
 
       private static readonly int _typeHashCode = typeof(global::Thinktecture.Tests.TestValueObject).GetHashCode();
 
+      /// <summary>
+      /// Default instance of <see cref="TestValueObject"/>.
+      /// </summary>
       public static readonly global::Thinktecture.Tests.TestValueObject Null = default;
 
       /// <summary>