only serialize parent property if it has members

src/Doki.Abstractions/DocumentationObject.cs

@@ -21,13 +21,15 @@ public abstract record DocumentationObject
     /// <summary>
     /// Gets the parent of the documentation object.
     /// </summary>
-    [JsonIgnore]
+    [JsonConverter(typeof(DocumentationObjectConverter))]
     public DocumentationObject? Parent { get; internal init; }
 
     /// <summary>
     /// Gets the content type of the documentation object.
     /// </summary>
     public DocumentationContentType ContentType { get; protected init; }
+
+    internal bool HasMembers { get; init; }
 
     protected DocumentationObject()
     {

src/Doki.Abstractions/DocumentationObjectConverter.cs

@@ -0,0 +1,26 @@
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace Doki;
+
+internal class DocumentationObjectConverter : JsonConverter<DocumentationObject>
+{
+    public override DocumentationObject? Read(ref Utf8JsonReader reader, Type typeToConvert,
+        JsonSerializerOptions options)
+    {
+        return (DocumentationObject?)JsonSerializer.Deserialize(ref reader, typeToConvert, options);
+    }
+
+    public override void Write(Utf8JsonWriter writer, DocumentationObject value, JsonSerializerOptions options)
+    {
+        if (!value.HasMembers)
+        {
+            writer.WriteNullValue();
+            return;
+        }
+
+        Console.WriteLine("Writing: {0}, {1}", value.Id, writer.CurrentDepth);
+
+        JsonSerializer.Serialize(writer, value, options);
+    }
+}

src/Doki.Abstractions/TypeDocumentationReference.cs

@@ -1,4 +1,5 @@
-namespace Doki;
+// ReSharper disable InconsistentNaming
+namespace Doki;
 
 /// <summary>
 /// Represents a type documentation reference in the documentation.
@@ -21,7 +22,7 @@ public record TypeDocumentationReference : MemberDocumentation
     public bool IsMicrosoft { get; init; }
 
     internal TypeDocumentationReference? InternalBaseType;
-    
+
     /// <summary>
     /// Gets the base type of the type.
     /// </summary>

src/Doki.Output.Json/JsonOutput.cs

@@ -1,10 +1,14 @@
 using System.Text.Json;
+using System.Text.Json.Serialization;
 
 namespace Doki.Output.Json;
 
 public sealed class JsonOutput(OutputOptions<JsonOutput> options) : IOutput
 {
-    private static readonly JsonSerializerOptions JsonSerializerOptions = new();
+    private static readonly JsonSerializerOptions JsonSerializerOptions = new()
+    {
+        DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingDefault
+    };
 
     public Task BeginAsync(CancellationToken cancellationToken = default)
     {

src/Doki/DocumentationGenerator.Content.cs

@@ -362,7 +362,7 @@ private DocumentationObject BuildCRefDocumentation(string cref, DocumentationObj
                 Text = memberName
             };
 
-        var typeDocumentationReference = BuildTypeDocumentationReference(type, parent);
+        var typeDocumentationReference = BuildTypeDocumentationReference(type, parent, true);
 
         switch (memberType)
         {
@@ -467,7 +467,8 @@ private DocumentationObject BuildCRefDocumentation(string cref, DocumentationObj
         }
     }
 
-    private TypeDocumentationReference BuildTypeDocumentationReference(Type type, DocumentationObject parent)
+    private TypeDocumentationReference BuildTypeDocumentationReference(Type type, DocumentationObject parent,
+        bool hasMembers = false)
     {
         var typeId = type.GetXmlDocumentationId();
 
@@ -484,7 +485,8 @@ private TypeDocumentationReference BuildTypeDocumentationReference(Type type, Do
             IsGeneric = type.IsGenericType,
             IsDocumented = IsTypeDocumented(type),
             IsMicrosoft = IsAssemblyFromMicrosoft(assembly),
-            Parent = parent
+            Parent = parent,
+            HasMembers = hasMembers
         };
 
         if (type.BaseType != null)

src/Doki/DocumentationGenerator.cs

@@ -346,6 +346,7 @@ private async Task<TypeDocumentation> GenerateTypeDocumentationAsync(GeneratorCo
             Assembly = context.Current.Assembly.GetName().Name,
             IsDocumented = true,
             IsGeneric = context.Current.IsGenericType,
+            HasMembers = true
         };
 
         if (summary != null) typeDocumentation.Summary = BuildXmlDocumentation(summary, typeDocumentation);