Update docs for v3, improve packaging script

- Highlight MemoryStreamSlim's perf vs. RecyclableMemoryStream and announce new ToMemory() API in docs
- Improve documentation formatting for clarity
- Refactor package.cmd to use dotnet CLI with explicit project path and remove msbuild usage

Author: kzdev-net

README.md

@@ -8,6 +8,12 @@ This repository contains the  ['KZDev.PerfUtils'](https://www.nuget.org/packages
 - **StringBuilderCache**: A utility for caching StringBuilder instances to improve performance in high-throughput scenarios.
 - **InterlockedOps**: A set of additional atomic thread-safe operations that extend the functionality of the Interlocked class in the .NET Class Library.
 
+> [!IMPORTANT]
+> **MemoryStreamSlim** outperforms **RecyclableMemoryStream** across all benchmarked categories in this project. See the benchmark documentation for workload-by-workload comparisons.
+
+> [!TIP]
+> **New in v3:** `MemoryStreamSlim.ToMemory()` provides a significantly more memory-efficient way to access raw stream buffers as `Memory<byte>`.
+
 ## Supported target frameworks
 
 This package targets **.NET 8** (`net8.0`), **.NET 9** (`net9.0`), and **.NET 10** (`net10.0`). The 3.x line does not ship builds for older TFMs (including **.NET 6**); upgrade consuming projects to a supported target framework before referencing the latest package versions.

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

@@ -6,6 +6,10 @@ The KZDev.PerfUtils package provides the following high-performance utility clas
 - `StringBuilderCache`: A thread-safe cache of **StringBuilder** instances to improve speed and reduce the overhead of memory allocations associated with the **StringBuilder** class.
 - `InterlockedOps`: A utility that extends the functionality of the **Interlocked** class in the .NET Class Library by providing additional atomic thread-safe operations.
 
+**Important:** **MemoryStreamSlim** outperforms **RecyclableMemoryStream** across all benchmarked categories in this project.
+
+**New in v3:** `MemoryStreamSlim.ToMemory()` introduces a significantly more memory-efficient way to access raw stream buffers as `Memory<byte>`.
+
 ## Supported target frameworks
 
 This package targets **.NET 8** (`net8.0`), **.NET 9** (`net9.0`), and **.NET 10** (`net10.0`). The 3.x line does not ship builds for older TFMs (including **.NET 6**); upgrade consuming projects to a supported target framework before referencing the latest package versions.

Source/Src/KZDev.PerfUtils/package.cmd

@@ -1,15 +1,15 @@
 @ECHO OFF
 SETLOCAL
+SET "PROJECTPATH=%~dp0KZDev.PerfUtils.csproj"
 SET SOLUTIONPATH=%~dp0..\..
 
 PUSHD %SOLUTIONPATH%
 
-dotnet clean -c Release
-dotnet restore
+dotnet clean "%PROJECTPATH%" -c Release
+dotnet restore "%PROJECTPATH%"
+dotnet pack "%PROJECTPATH%" -c Release --no-restore -p:IsPacking=true -p:ContinuousIntegrationBuild=true
 
 POPD
- 
-dotnet msbuild -t:Pack -p:IsPacking=true -p:Configuration=Release -p:ContinuousIntegrationBuild=true
 
 :EOF
 ENDLOCAL