Fix doc links

Author: eiriktsarpalis

Makefile

@@ -54,7 +54,8 @@ pack: build
 push:
 	dotnet nuget push $(ARTIFACT_PATH)/*.nupkg -s $(NUGET_SOURCE) -k $(NUGET_API_KEY)
 
-generate-docs: build
+generate-docs: restore
+	dotnet build -c Release
 	dotnet docfx $(DOCS_PATH)/docfx.json --warningsAsErrors true
 
 serve-docs: generate-docs

docs/shape-providers.md

@@ -172,9 +172,9 @@ For example, serializers may need to jump from a type shape to its converter.
 
 [!code-csharp[](CSharpSamples/AssociatedTypes.cs#TypeShapeOneType)]
 
-Use the @PolyType.ITypeShape.GetAssociatedTypeShape*?displayProperty=nameWithType method to obtain the shape of an associated type.
-The @PolyType.SourceGenModel.SourceGenTypeShapeProvider implementation of this method requires that the associated types be pre-determined at compile time via attributes.
-The @PolyType.ReflectionProvider.ReflectionTypeShapeProvider is guaranteed to work with all types and therefore does _not_ require these attributes.
+Use the <xref:PolyType.ITypeShape.GetAssociatedTypeShape*> method to obtain the shape of an associated type.
+The <xref:PolyType.SourceGenModel.SourceGenTypeShapeProvider> implementation of this method requires that the associated types be pre-determined at compile time via attributes.
+The <xref:PolyType.ReflectionProvider.ReflectionTypeShapeProvider> is guaranteed to work with all types and therefore does _not_ require these attributes.
 Thus, it can be valuable to test your associated types code with the source generation provider to ensure your code is AOT-compatible.
 
 An associated type must have at least `internal` visibility for its shape to be generated for use within its same assembly.
@@ -190,20 +190,20 @@ This can be appropriate for a serializer that needs to jump from a generic data
 
 [!code-csharp[](CSharpSamples/AssociatedTypes.cs#SerializerConverter)]
 
-Only @PolyType.SourceGenModel.SourceGenTypeShapeProvider produces partial shapes.
-The @PolyType.ReflectionProvider.ReflectionTypeShapeProvider always produces complete shapes.
+Only <xref:PolyType.SourceGenModel.SourceGenTypeShapeProvider> produces partial shapes.
+The <xref:PolyType.ReflectionProvider.ReflectionTypeShapeProvider> always produces complete shapes.
 
-At present, only @PolyType.Abstractions.IObjectTypeShape shapes are generated partially.
+At present, only <xref:PolyType.Abstractions.IObjectTypeShape> shapes are generated partially.
 Shapes for collections, enums, unions, etc. are generated as full shapes.
 
-Type associations can be defined directly on the originating type via @PolyType.AssociatedTypeShapeAttribute.AssociatedTypes?displayProperty=nameWithType when that type and its associated type are in the same assembly.
-When the associated type is in another assembly, use @PolyType.TypeShapeExtensionAttribute.AssociatedTypes?displayProperty=nameWithType in the assembly that declares the associated type.
+Type associations can be defined directly on the originating type via <xref:PolyType.AssociatedTypeShapeAttribute.AssociatedTypes> when that type and its associated type are in the same assembly.
+When the associated type is in another assembly, use <xref:PolyType.TypeShapeExtensionAttribute.AssociatedTypes> in the assembly that declares the associated type.
 You can also define a custom attribute that can define associated types by attributing your own custom attribute with @PolyType.Abstractions.AssociatedTypeAttributeAttribute.
 
 ### TypeShapeExtensionAttribute
 
-The @PolyType.TypeShapeExtensionAttribute is an assembly-level attribute.
-It is very similar to @PolyType.TypeShapeAttribute, but it is used to customize the generated shape for a type that your assembly does not declare.
+The <xref:PolyType.TypeShapeExtensionAttribute> is an assembly-level attribute.
+It is very similar to <xref:PolyType.TypeShapeAttribute>, but it is used to customize the generated shape for a type that your assembly does not declare.
 
 ### Polymorphic types
 

src/PolyType/SourceGenModel/Helpers/ArgumentStatePool.cs

@@ -0,0 +1,51 @@
+using System.Runtime.CompilerServices;
+using System.Collections.Concurrent;
+using System.Threading;
+
+namespace PolyType.SourceGenModel;
+
+/// <summary>
+/// Defines a thread-safe pool for reusing <see cref="System.Runtime.CompilerServices.StrongBox{T}"/> instances.
+/// </summary>
+public sealed class StrongBoxPool<T> where T : struct
+{
+    // Bounded pool size to avoid unbounded retention of boxed struct values.
+    private const int MaxPoolSize = 256;
+    private readonly ConcurrentQueue<StrongBox<T>> _queue = new();
+    private int _count; // number of items currently stored in the queue
+
+    /// <summary>Rents a <see cref="StrongBox{T}"/> whose <see cref="StrongBox{T}.Value"/> is initialized to <paramref name="value"/>.</summary>
+    public StrongBox<T> Rent(T value)
+    {
+        if (_queue.TryDequeue(out StrongBox<T>? box))
+        {
+            Interlocked.Decrement(ref _count);
+            box.Value = value; // overwrite previous value
+            return box;
+        }
+
+        return new(value);
+    }
+
+    /// <summary>Returns a previously rented <see cref="StrongBox{T}"/> to the pool.</summary>
+    public void Return(StrongBox<T> box)
+    {
+        if (box is null)
+        {
+            return;
+        }
+
+        // Clear value to avoid holding onto large structs inadvertently.
+        box.Value = default;
+
+        // Fast path: if we've already reached capacity just drop the box.
+        if (Volatile.Read(ref _count) >= MaxPoolSize)
+        {
+            return; // let it be GC'ed
+        }
+
+        _queue.Enqueue(box);
+        // If we went over capacity due to a race we simply allow a slight overflow.
+        Interlocked.Increment(ref _count);
+    }
+}

tests/PolyType.Benchmarks/JsonBenchmark.cs

@@ -25,7 +25,7 @@ public static class JsonData
     public static readonly JsonConverter<MyPoco> PolyTypeSourceGen = JsonSerializerTS.CreateConverter<MyPoco>();
 }
 
-[MemoryDiagnoser(false)]
+[MemoryDiagnoser]
 [HideColumns("Job", "Error", "StdDev", "Median", "RatioSD")]
 public class JsonSerializeBenchmark
 {
@@ -80,7 +80,7 @@ public void Reset()
     }
 }
 
-[MemoryDiagnoser(false)]
+[MemoryDiagnoser()]
 [HideColumns("Job", "Error", "StdDev", "Median", "RatioSD")]
 public class JsonDeserializeBenchmark
 {