Update some misc. package information and documentation files.

Add benchmarks, update docs, and extend copyright

Updated toc.yml to include new benchmark sections and results.
Modified solution file to include new markdown files.
Extended copyright year to 2025 in Directory.Build.props.
Updated csproj with new StringBuilderCache class details.
Enhanced nuget.readme.md with StringBuilderCache info.
Added StringBuilderCache methods and .NET Events monitoring.

Author: kzdev-net

Source/Docs/articles/toc.yml

@@ -9,6 +9,21 @@
       href: stringbuildercache-monitoring.md
     - name: Benchmarks
       href: stringbuildercache-benchmarks.md
+      items:
+        - name: Single Thread Benchmarks
+          href: wrapper-throughput-benchmarks.md
+          items:
+            - name: Benchmark Results
+              href: StringsBenchmarks.StringBuilderThroughputBenchmarks-report-github.md
+            - name: Benchmark Results (Full HTML Table)
+              href: StringsBenchmarks.StringBuilderThroughputBenchmarks-report.html
+        - name: Multiple Thread Benchmarks
+          href: continuous-growth-throughput-benchmarks.md
+          items:
+            - name: Benchmark Results
+              href: StringsBenchmarks.StringBuilderMultipleThreadThroughputBenchmarks-report-github.md
+            - name: Benchmark Results (Full HTML Table)
+              href: StringsBenchmarks.StringBuilderMultipleThreadThroughputBenchmarks-report.html
 - name: Memory Stream
   href: memorystreamslim.md
   items:

Source/KZDev.PerfUtils.sln

@@ -99,6 +99,10 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Articles", "Articles", "{B9
 		Docs\articles\stringbuildercache-multithread-throughput-benchmarks.md = Docs\articles\stringbuildercache-multithread-throughput-benchmarks.md
 		Docs\articles\stringbuildercache-throughput-benchmarks.md = Docs\articles\stringbuildercache-throughput-benchmarks.md
 		Docs\articles\stringbuildercache.md = Docs\articles\stringbuildercache.md
+		Docs\articles\StringsBenchmarks.StringBuilderMultipleThreadThroughputBenchmarks-report-github.md = Docs\articles\StringsBenchmarks.StringBuilderMultipleThreadThroughputBenchmarks-report-github.md
+		Docs\articles\StringsBenchmarks.StringBuilderMultipleThreadThroughputBenchmarks-report.html = Docs\articles\StringsBenchmarks.StringBuilderMultipleThreadThroughputBenchmarks-report.html
+		Docs\articles\StringsBenchmarks.StringBuilderThroughputBenchmarks-report-github.md = Docs\articles\StringsBenchmarks.StringBuilderThroughputBenchmarks-report-github.md
+		Docs\articles\StringsBenchmarks.StringBuilderThroughputBenchmarks-report.html = Docs\articles\StringsBenchmarks.StringBuilderThroughputBenchmarks-report.html
 		Docs\articles\toc.yml = Docs\articles\toc.yml
 		Docs\articles\wrapper-throughput-benchmarks.md = Docs\articles\wrapper-throughput-benchmarks.md
 	EndProjectSection

Source/Src/Directory.Build.props

@@ -11,7 +11,7 @@
         <TargetFrameworks>net8.0;net6.0</TargetFrameworks>
         <Version>1.2.0</Version>
         <Authors>Kevin Zehrer</Authors>
-        <Copyright>Copyright © 2024 Kevin Zehrer. All rights reserved.</Copyright>
+        <Copyright>Copyright © 2024-2025 Kevin Zehrer. All rights reserved.</Copyright>
         <Product>KZDev Performance Utilities</Product>
         <PackageRequireLicenseAcceptance>true</PackageRequireLicenseAcceptance>
     </PropertyGroup>

Source/Src/KZDev.PerfUtils/KZDev.PerfUtils.csproj

@@ -11,8 +11,8 @@
 		<PackageReadmeFile>docs\README.md</PackageReadmeFile>
 		<PackageIcon>images\icon.png</PackageIcon>
 		<PackageLicenseExpression>MIT</PackageLicenseExpression>
-		<PackageDescription>Performance utilities for .NET projects, including the 'MemoryStreamSlim' class; a high-performance, memory-efficient, and easy-to-use replacement for 'MemoryStream', and the 'InterlockedOps' class which has additional thread-safe atomic operations beyond those provided by the 'Interlocked' class.</PackageDescription>
-		<PackageReleaseNotes>Further MemoryStreamSlim performance enhancements and added InterlockedOps class (version 1.1.0).</PackageReleaseNotes>
+		<PackageDescription>Performance utilities for .NET projects, including the 'MemoryStreamSlim', 'StringBuilderCache', and 'InterlockedOps' classes.</PackageDescription>
+		<PackageReleaseNotes>MemoryStreamSlim idle memory trimming and added StringBuilder class (version 1.2.0).</PackageReleaseNotes>
 		<EmbedUntrackedSources>true</EmbedUntrackedSources>
 		<RepositoryUrl>https://github.com/kzdev-net/kzdev.perfutils</RepositoryUrl>
 	</PropertyGroup>

Source/Src/KZDev.PerfUtils/Package/nuget.readme.md

@@ -1,6 +1,10 @@
 # KZDev.PerfUtils
 
-This package contains the `MemoryStreamSlim` class; a high-performance, memory-efficient, and easy-to-use replacement for the `MemoryStream` class that provides particular performance benefits for large or frequently used streams. The package also contains the `InterlockedOps` class, which provides additional atomic thread-safe operations to extend the functionality of the `Interlocked` class in the .NET Class Library.
+The `KZDev.PerfUtils` package contains the following performance utility classes:
+
+- `MemoryStreamSlim` - a high-performance, memory-efficient, easy-to-use replacement for the `MemoryStream` class that provides particular performance benefits for large or frequently used streams. 
+- `StringBuilderCache` - a thread-safe cache of `StringBuilder` instances to improve speed and reduce the overhead of memory allocations associated with using the `StringBuilder` class. 
+- `InterlockedOps` - which provides additional atomic thread-safe operations to extend the functionality of the `Interlocked` class in the .NET Class Library.
 
 ## Features
 
@@ -12,6 +16,14 @@ This package contains the `MemoryStreamSlim` class; a high-performance, memory-e
 * Simple replacement for `MemoryStream` with the same API, other than the constructor.
 * Optionally allows using native memory for storage, which allows even more flexibility to minimize GC pressure.
 
+`StringBuilderCache` is a static class that provides a thread-safe cache of `StringBuilder` instances to reduce the number of allocations and deallocations of `StringBuilder` objects in high-throughput scenarios with simple operations:
+
+* Acquire : Get a `StringBuilder` instance from the cache.
+* Release : Return a `StringBuilder` instance to the cache.
+* GetStringAndRelease : Get the string from a `StringBuilder` instance and return it to the cache.
+* GetScope : Get a `using` scoped `StringBuilder` instance from the cache and return it to the cache when the scope is exited.
+* Monitoring with `Events` feature of the .NET runtime for detailed cache management.
+
 `InterlockedOps` is a static class providing the following thread-safe atomic operations:
 
 * Xor : Exclusive OR operation on any integer types.