diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index ba878f7c4..8251ac51e 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -40,6 +40,15 @@ jobs:
       
       - name: Build
         run: dotnet build -c Release --no-restore
+
+      - name: Pack documentation dependencies
+        if: matrix.framework == 'net10.0'
+        run: dotnet pack Respire.slnx -c Release --no-build -p:Version=0.0.0-docs -o artifacts/package/release
+
+      - name: Compile documentation snippets
+        if: matrix.framework == 'net10.0'
+        shell: pwsh
+        run: ./scripts/Verify-DocSnippets.ps1 -PackagesPath artifacts/package/release -Version 0.0.0-docs
       
       - name: Run Unit Tests
         run: |
diff --git a/.gitignore b/.gitignore
index 08c92d003..f9007c87b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,6 +1,7 @@
 # Build results
 bin/
 obj/
+artifacts/
 BenchmarkDotNet.Artifacts/
 TestResults/
 
diff --git a/README.md b/README.md
index a3ac213bd..a66473f18 100644
--- a/README.md
+++ b/README.md
@@ -277,6 +277,7 @@ pass through a Respire serializer.
 
 ### Dependency injection
 
+<!-- doc-test-tail-declaration: split-before=public sealed class CartService -->
 ```csharp
 builder.Services.AddRespire(builder.Configuration.GetConnectionString("redis")!);
 
@@ -297,6 +298,7 @@ Standalone clients surface setup exceptions directly, while cluster clients wrap
 Typed values use reflection-based System.Text.Json metadata by default. For a trimmed or NativeAOT
 application, generate metadata for every stored type and pass that context to Respire:
 
+<!-- doc-test-tail-declaration: split-before=[JsonSerializable -->
 ```csharp
 using System.Text.Json.Serialization;
 using Respire;
diff --git a/scripts/Verify-DocSnippets.ps1 b/scripts/Verify-DocSnippets.ps1
new file mode 100644
index 000000000..883e1f59b
--- /dev/null
+++ b/scripts/Verify-DocSnippets.ps1
@@ -0,0 +1,351 @@
+[CmdletBinding()]
+param(
+    [Parameter(Mandatory)]
+    [string]$PackagesPath,
+
+    [Parameter(Mandatory)]
+    [string]$Version
+)
+
+$ErrorActionPreference = 'Stop'
+
+$repositoryRoot = Split-Path $PSScriptRoot -Parent
+$resolvedPackagesPath = (Resolve-Path -LiteralPath $PackagesPath).Path
+$generatedDirectory = Join-Path $repositoryRoot 'artifacts/doc-tests/generated'
+$generatedPath = Join-Path $generatedDirectory 'GeneratedSnippets.g.cs'
+$nugetConfigPath = Join-Path $generatedDirectory 'NuGet.config'
+$restorePackagesPath = Join-Path $generatedDirectory 'packages'
+$projectPath = Join-Path $repositoryRoot 'tests/Respire.DocTests/Respire.DocTests.csproj'
+$documentPaths = @(
+    (Join-Path $repositoryRoot 'README.md')
+    Get-ChildItem (Join-Path $repositoryRoot 'website/docs') -Recurse -File -Include '*.md', '*.mdx' |
+        Sort-Object FullName |
+        ForEach-Object FullName
+)
+
+$requiredPackages = @(
+    'Respire'
+    'Respire.Extensions.Caching'
+    'Respire.Extensions.Caching.Hybrid'
+    'Respire.Extensions.DependencyInjection'
+)
+
+foreach ($packageId in $requiredPackages)
+{
+    $packagePath = Join-Path $resolvedPackagesPath "$packageId.$Version.nupkg"
+    if (-not (Test-Path -LiteralPath $packagePath -PathType Leaf))
+    {
+        throw "Documented package '$packageId' was not packed at '$packagePath'."
+    }
+}
+
+$snippets = [System.Collections.Generic.List[object]]::new()
+$installPackageIds = [System.Collections.Generic.HashSet[string]]::new([StringComparer]::Ordinal)
+$projectCommands = [System.Collections.Generic.HashSet[string]]::new([StringComparer]::Ordinal)
+
+foreach ($documentPath in $documentPaths)
+{
+    $relativePath = [IO.Path]::GetRelativePath($repositoryRoot, $documentPath).Replace('\', '/')
+    $lines = Get-Content -LiteralPath $documentPath
+    $csharpOrdinal = 0
+
+    for ($lineIndex = 0; $lineIndex -lt $lines.Count; $lineIndex++)
+    {
+        $fenceMatch = [regex]::Match(
+            $lines[$lineIndex],
+            '^(?<indent> {0,3})(?<delimiter>`{3,}|~{3,})(?<info>.*)$')
+        if (-not $fenceMatch.Success)
+        {
+            continue
+        }
+
+        $delimiter = $fenceMatch.Groups['delimiter'].Value
+        $closingFencePattern = '^ {0,3}' + [regex]::Escape($delimiter[0]) +
+            "{$($delimiter.Length),}\s*$"
+        $info = $fenceMatch.Groups['info'].Value.Trim()
+
+        if ($info -match '^csharp(?:\s+.*)?$')
+        {
+            $csharpOrdinal++
+            $startLine = $lineIndex + 2
+            $body = [System.Collections.Generic.List[string]]::new()
+            for ($lineIndex++; $lineIndex -lt $lines.Count -and $lines[$lineIndex] -notmatch $closingFencePattern; $lineIndex++)
+            {
+                $body.Add($lines[$lineIndex])
+            }
+
+            if ($lineIndex -ge $lines.Count)
+            {
+                throw "Unclosed C# fence at ${relativePath}:$startLine."
+            }
+
+            $directive = if ($startLine -ge 3) { $lines[$startLine - 3].Trim() } else { '' }
+            $ignoreReason = $null
+            if ($directive -match '^<!--\s*doc-test-ignore:\s*(.+?)\s*-->$')
+            {
+                $ignoreReason = $Matches[1]
+            }
+
+            $ignored = $null -ne $ignoreReason
+            if ($directive -match '^<!--\s*doc-test-ignore' -and -not $ignored)
+            {
+                throw "Malformed doc-test-ignore directive before ${relativePath}:$startLine. Include a non-empty reason."
+            }
+
+            $mode = 'statements'
+            $splitBefore = $null
+            if ($directive -match '^<!--\s*doc-test-declaration:\s*split-before=(.+?)\s*-->$')
+            {
+                $mode = 'declaration'
+                $splitBefore = $Matches[1]
+            }
+            elseif ($directive -match '^<!--\s*doc-test-tail-declaration:\s*split-before=(.+?)\s*-->$')
+            {
+                $mode = 'tail-declaration'
+                $splitBefore = $Matches[1]
+            }
+            elseif ($directive -match '^<!--\s*doc-test-declaration\s*-->$')
+            {
+                $mode = 'declaration'
+            }
+            elseif ($directive -match '^<!--\s*doc-test-' -and -not $ignored)
+            {
+                throw "Unknown or malformed doc-test directive before ${relativePath}:$startLine."
+            }
+
+            $source = $body -join "`n"
+            if ($ignored)
+            {
+                Write-Host "EXCLUDED $relativePath#$csharpOrdinal ($ignoreReason)"
+                continue
+            }
+
+            $snippets.Add([pscustomobject]@{
+                Id = "$relativePath#$csharpOrdinal"
+                SourcePath = $documentPath.Replace('\', '/')
+                Line = $startLine
+                Source = $source
+                Mode = $mode
+                SplitBefore = $splitBefore
+            })
+
+            continue
+        }
+
+        if ($info -match '^(?:bash|sh|shell|powershell|pwsh)(?:\s+.*)?$')
+        {
+            for ($lineIndex++; $lineIndex -lt $lines.Count -and $lines[$lineIndex] -notmatch $closingFencePattern; $lineIndex++)
+            {
+                $command = $lines[$lineIndex].Trim()
+                if ($command -match '^dotnet (?:add package|package add)\s+([A-Za-z0-9_.-]+)')
+                {
+                    [void]$installPackageIds.Add($Matches[1])
+                }
+
+                if ($command -match '^dotnet (?:add reference|reference add)\s+([^\s]+)')
+                {
+                    $referencePath = $Matches[1].Trim("'`"").Replace('\', '/') -replace
+                        '^path/to/Respire/', ''
+                    [void]$projectCommands.Add($referencePath)
+                }
+
+                if ($command -match '^dotnet run\s+.*--project\s+([^\s]+)')
+                {
+                    [void]$projectCommands.Add($Matches[1].Trim("'`""))
+                }
+                elseif ($command -match '^dotnet test\s+--project\s+([^\s]+)')
+                {
+                    [void]$projectCommands.Add($Matches[1].Trim("'`""))
+                }
+                elseif ($command -match '^dotnet test\s+(?!-)([^\s]+)')
+                {
+                    [void]$projectCommands.Add($Matches[1].Trim("'`""))
+                }
+            }
+        }
+    }
+}
+
+foreach ($packageId in $installPackageIds)
+{
+    if ($packageId -notin $requiredPackages)
+    {
+        throw "Shell sample references unexpected package ID '$packageId'."
+    }
+}
+
+foreach ($relativeProjectPath in $projectCommands)
+{
+    $commandPath = Join-Path $repositoryRoot $relativeProjectPath
+    $projectExists = $false
+    if (Test-Path -LiteralPath $commandPath -PathType Leaf)
+    {
+        $projectExists = (Get-Item -LiteralPath $commandPath).Extension -in
+            '.csproj', '.fsproj', '.vbproj'
+    }
+    elseif (Test-Path -LiteralPath $commandPath -PathType Container)
+    {
+        $projectExists = $null -ne (Get-ChildItem -LiteralPath $commandPath -File |
+            Where-Object { $_.Extension -in '.csproj', '.fsproj', '.vbproj' } |
+            Select-Object -First 1)
+    }
+
+    if (-not $projectExists)
+    {
+        throw "Shell sample references missing project '$relativeProjectPath'."
+    }
+}
+
+New-Item -ItemType Directory -Force -Path $generatedDirectory | Out-Null
+if (Test-Path -LiteralPath $restorePackagesPath)
+{
+    Remove-Item -LiteralPath $restorePackagesPath -Recurse -Force
+}
+
+$builder = [Text.StringBuilder]::new()
+[void]$builder.AppendLine('// <auto-generated />')
+[void]$builder.AppendLine('using System.Text.Json.Serialization;')
+[void]$builder.AppendLine('using Microsoft.Extensions.Caching.Distributed;')
+[void]$builder.AppendLine('using Microsoft.Extensions.Configuration;')
+[void]$builder.AppendLine('using Microsoft.Extensions.DependencyInjection;')
+[void]$builder.AppendLine('using Microsoft.Extensions.Logging;')
+[void]$builder.AppendLine('using OpenTelemetry.Metrics;')
+[void]$builder.AppendLine('using OpenTelemetry.Trace;')
+[void]$builder.AppendLine('using Respire;')
+[void]$builder.AppendLine('using Respire.Extensions.Caching;')
+[void]$builder.AppendLine('using Respire.Extensions.Caching.Hybrid;')
+[void]$builder.AppendLine('using Respire.Extensions.DependencyInjection;')
+[void]$builder.AppendLine('using Respire.Serialization;')
+[void]$builder.AppendLine('#pragma warning disable')
+
+$usingPattern = '(?m)^\s*(?:global\s+)?using\s+(?:(?:static\s+)?[A-Za-z_][A-Za-z0-9_.]*|[A-Za-z_][A-Za-z0-9_]*\s*=\s*(?:global::)?[A-Za-z_][A-Za-z0-9_.]*)\s*;\s*(?://.*)?$'
+for ($snippetIndex = 0; $snippetIndex -lt $snippets.Count; $snippetIndex++)
+{
+    $snippet = $snippets[$snippetIndex]
+    $usingDirectives = [regex]::Matches($snippet.Source, $usingPattern) |
+        ForEach-Object { $_.Value.Trim() -replace '^global\s+', '' }
+    $source = [regex]::Replace($snippet.Source, $usingPattern, '')
+    $source = $source -replace '(?m)^\s*#pragma\s+warning\s+(?:disable|restore).*$', ''
+
+    $declarationLine = $snippet.Line
+    $statementLine = $snippet.Line
+    $sourceSplitIndex = -1
+    if ($null -ne $snippet.SplitBefore)
+    {
+        $originalSplitIndex = $snippet.Source.IndexOf($snippet.SplitBefore, [StringComparison]::Ordinal)
+        $sourceSplitIndex = $source.IndexOf($snippet.SplitBefore, [StringComparison]::Ordinal)
+        if ($originalSplitIndex -lt 0 -or $sourceSplitIndex -lt 0)
+        {
+            throw "Split marker '$($snippet.SplitBefore)' was not found in $($snippet.Id)."
+        }
+
+        $splitLine = $snippet.Line +
+            [regex]::Matches($snippet.Source.Substring(0, $originalSplitIndex), "`n").Count
+        if ($snippet.Mode -eq 'declaration')
+        {
+            $statementLine = $splitLine
+        }
+        else
+        {
+            $declarationLine = $splitLine
+        }
+    }
+
+    [void]$builder.AppendLine('namespace Respire.DocTests')
+    [void]$builder.AppendLine('{')
+    foreach ($usingDirective in $usingDirectives)
+    {
+        [void]$builder.AppendLine($usingDirective)
+    }
+    [void]$builder.AppendLine("internal sealed partial class Snippet$snippetIndex : SnippetContext")
+    [void]$builder.AppendLine('{')
+
+    if ($snippet.Mode -eq 'declaration')
+    {
+        if ($null -eq $snippet.SplitBefore)
+        {
+            $declarationSource = $source.TrimEnd()
+            $source = ''
+        }
+        else
+        {
+            $declarationSource = $source.Substring(0, $sourceSplitIndex).TrimEnd()
+            $source = $source.Substring($sourceSplitIndex)
+        }
+
+        [void]$builder.AppendLine("#line $declarationLine `"$($snippet.SourcePath)`"")
+        foreach ($line in ($declarationSource -split "`n"))
+        {
+            [void]$builder.AppendLine("    $line")
+        }
+        [void]$builder.AppendLine('#line default')
+    }
+    elseif ($snippet.Mode -eq 'tail-declaration')
+    {
+        $declarationSource = $source.Substring($sourceSplitIndex).TrimEnd()
+        $source = $source.Substring(0, $sourceSplitIndex).TrimEnd()
+        [void]$builder.AppendLine("#line $declarationLine `"$($snippet.SourcePath)`"")
+        foreach ($line in ($declarationSource -split "`n"))
+        {
+            [void]$builder.AppendLine("    $line")
+        }
+        [void]$builder.AppendLine('#line default')
+    }
+
+    [void]$builder.AppendLine('    public static async Task RunAsync()')
+    [void]$builder.AppendLine('    {')
+    if (-not [string]::IsNullOrWhiteSpace($source))
+    {
+        [void]$builder.AppendLine("#line $statementLine `"$($snippet.SourcePath)`"")
+        foreach ($line in ($source -split "`n"))
+        {
+            [void]$builder.AppendLine("        $line")
+        }
+        [void]$builder.AppendLine('#line default')
+    }
+    [void]$builder.AppendLine('    }')
+    [void]$builder.AppendLine('}')
+    [void]$builder.AppendLine('}')
+}
+
+[void]$builder.AppendLine('namespace Respire.DocTests')
+[void]$builder.AppendLine('{')
+[void]$builder.AppendLine('internal static class SnippetCatalog')
+[void]$builder.AppendLine('{')
+[void]$builder.AppendLine('    public static void Report() =>')
+[void]$builder.AppendLine("        Console.WriteLine(`"Compiled $($snippets.Count) C# documentation snippets.`");")
+[void]$builder.AppendLine('}')
+[void]$builder.AppendLine('}')
+
+[IO.File]::WriteAllText($generatedPath, $builder.ToString())
+
+[IO.File]::WriteAllText(
+    $nugetConfigPath,
+    @"
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+  <packageSources>
+    <clear />
+    <add key="local-packages" value="$([Security.SecurityElement]::Escape($resolvedPackagesPath))" />
+    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
+  </packageSources>
+</configuration>
+"@)
+
+& dotnet restore $projectPath --configfile $nugetConfigPath --force --packages $restorePackagesPath `
+    "-p:RespirePackageVersion=$Version" `
+    "-p:GeneratedSnippetsPath=$generatedPath"
+
+if ($LASTEXITCODE -ne 0)
+{
+    throw "Documentation snippet restore failed with exit code $LASTEXITCODE."
+}
+
+& dotnet run --project $projectPath -c Release --no-restore `
+    "-p:RespirePackageVersion=$Version" `
+    "-p:GeneratedSnippetsPath=$generatedPath"
+
+if ($LASTEXITCODE -ne 0)
+{
+    throw "Documentation snippet project failed with exit code $LASTEXITCODE."
+}
diff --git a/tests/Respire.DocTests/Program.cs b/tests/Respire.DocTests/Program.cs
new file mode 100644
index 000000000..cf2e45dff
--- /dev/null
+++ b/tests/Respire.DocTests/Program.cs
@@ -0,0 +1,70 @@
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Logging.Abstractions;
+using Respire;
+
+namespace Respire.DocTests;
+
+internal static class Program
+{
+    public static void Main() => SnippetCatalog.Report();
+}
+
+#pragma warning disable CS0162, CS0169, CS0219, CS0414, CS0649, CS1998
+
+internal abstract class SnippetContext
+{
+    protected static readonly IRespireClient redis = null!;
+    protected static readonly RespireLock mutex = null!;
+    protected static readonly CancellationToken cancellationToken = default;
+    protected static readonly CancellationToken stoppingToken = default;
+    protected static readonly CancellationToken token = default;
+    protected static readonly string requestId = "request";
+    protected static readonly string payload = "{}";
+    protected static readonly string json = "{}";
+    protected static readonly string orderJson = "{}";
+    protected static readonly string sessionId = "session";
+    protected static readonly RespireKey[] keys = ["key"];
+    protected static readonly long userId = 1;
+    protected static readonly DateTimeOffset midnight = DateTimeOffset.UtcNow.AddDays(1);
+    protected static readonly RespireOptions options = new();
+    protected static readonly IConfiguration configuration = new ConfigurationBuilder().Build();
+    protected static readonly ILogger logger = NullLogger.Instance;
+    protected static readonly ILoggerFactory loggerFactory = NullLoggerFactory.Instance;
+    protected static readonly DocumentationBuilder builder = new();
+    protected static readonly DocumentationHealthState healthState = new();
+    protected static readonly RespireMessage message = default;
+
+    protected static void Process(ReadOnlySpan<byte> _) { }
+
+    protected static ValueTask HandleAsync(string? _) => ValueTask.CompletedTask;
+
+    protected static ValueTask InspectAsync(string _) => ValueTask.CompletedTask;
+
+    protected static ValueTask ProcessAsync(string _, CancellationToken __) => ValueTask.CompletedTask;
+
+    protected static ValueTask RunReportAsync(CancellationToken _ = default) => ValueTask.CompletedTask;
+}
+
+internal sealed class DocumentationBuilder
+{
+    public IServiceCollection Services { get; } = new ServiceCollection();
+
+    public IConfiguration Configuration { get; } = new ConfigurationBuilder().Build();
+}
+
+internal sealed class DocumentationHealthState
+{
+    public void Update(RespireEndpoint _, RespireConnectionState __, Exception? ___) { }
+}
+
+internal sealed record User(string Name = "Ada", int Age = 36);
+
+internal sealed record Order;
+
+internal sealed record OrderCreated;
+
+internal sealed record CachedJob;
+
+internal sealed record Session;
diff --git a/tests/Respire.DocTests/Respire.DocTests.csproj b/tests/Respire.DocTests/Respire.DocTests.csproj
new file mode 100644
index 000000000..0e3d32462
--- /dev/null
+++ b/tests/Respire.DocTests/Respire.DocTests.csproj
@@ -0,0 +1,26 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFrameworks></TargetFrameworks>
+    <TargetFramework>net10.0</TargetFramework>
+    <OutputType>Exe</OutputType>
+    <IsPackable>false</IsPackable>
+    <ManagePackageVersionsCentrally>false</ManagePackageVersionsCentrally>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Respire" Version="$(RespirePackageVersion)" />
+    <PackageReference Include="Respire.Extensions.Caching" Version="$(RespirePackageVersion)" />
+    <PackageReference Include="Respire.Extensions.Caching.Hybrid" Version="$(RespirePackageVersion)" />
+    <PackageReference Include="Respire.Extensions.DependencyInjection" Version="$(RespirePackageVersion)" />
+    <PackageReference Include="Microsoft.Extensions.Configuration" Version="10.0.11" />
+    <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="10.0.11" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Abstractions" Version="10.0.11" />
+    <PackageReference Include="OpenTelemetry.Extensions.Hosting" Version="1.18.0" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <Compile Include="$(GeneratedSnippetsPath)" Link="GeneratedSnippets.g.cs" />
+  </ItemGroup>
+
+</Project>
diff --git a/website/docs/commands/strings-and-keys.md b/website/docs/commands/strings-and-keys.md
index d5a47ae4e..f75089ed7 100644
--- a/website/docs/commands/strings-and-keys.md
+++ b/website/docs/commands/strings-and-keys.md
@@ -32,6 +32,7 @@ bool created = await redis.SetAsync(
 `RespireExpiry` is the single expiry argument: nothing, a relative TTL, an absolute instant, or "keep the TTL the key already has". A `TimeSpan` or `DateTimeOffset` converts implicitly.
 
 ```csharp
+string token = "session-token";
 await redis.SetAsync("session:42", token);                                  // no TTL (clears any existing one)
 await redis.SetAsync("session:42", token, TimeSpan.FromMinutes(30));        // PX
 await redis.SetAsync("session:42", token, RespireExpiry.At(midnight));         // PXAT
diff --git a/website/docs/fundamentals/client-side-caching.md b/website/docs/fundamentals/client-side-caching.md
index 07623f7e2..e3d7c1465 100644
--- a/website/docs/fundamentals/client-side-caching.md
+++ b/website/docs/fundamentals/client-side-caching.md
@@ -83,6 +83,7 @@ clears affected cache state instead of trusting entries whose invalidations may
 
 Tune entry count, approximate owned bytes, and local TTL together:
 
+<!-- doc-test-ignore: Object-initializer fragment for the RespireOptions.ClientSideCache property. -->
 ```csharp
 ClientSideCache = new RespireClientSideCacheOptions
 {
diff --git a/website/docs/fundamentals/values-and-serialization.md b/website/docs/fundamentals/values-and-serialization.md
index ff20605cb..987da37f2 100644
--- a/website/docs/fundamentals/values-and-serialization.md
+++ b/website/docs/fundamentals/values-and-serialization.md
@@ -51,6 +51,7 @@ else if (hits == 0) { /* key holds 0 */ }
 
 `SetAsync<T>` and `GetAsync<T>` use `RespireOptions.Serializer` for object values. `SystemTextJsonSerializer` is the default. Supply an `IRespireSerializer` for another format:
 
+<!-- doc-test-ignore: MyMessagePackSerializer is the application's omitted IRespireSerializer implementation. -->
 ```csharp
 var options = new RespireOptions
 {
diff --git a/website/docs/getting-started.md b/website/docs/getting-started.md
index 9d8631766..62d8b1af7 100644
--- a/website/docs/getting-started.md
+++ b/website/docs/getting-started.md
@@ -50,6 +50,7 @@ Console.WriteLine(state);
 
 The default serializer uses `System.Text.Json`:
 
+<!-- doc-test-declaration: split-before=await redis -->
 ```csharp
 public sealed record User(string Name, int LoginCount);
 
diff --git a/website/docs/guides/batches-and-transactions.md b/website/docs/guides/batches-and-transactions.md
index eec152f8a..9dd79d94e 100644
--- a/website/docs/guides/batches-and-transactions.md
+++ b/website/docs/guides/batches-and-transactions.md
@@ -49,6 +49,7 @@ RespireBatchResult result = await batch.ExecuteAsync();
 Both types implement `IRespireCommandQueue`, which unifies every deferred facet and the root
 shortcuts. Helpers can therefore queue work across facets without choosing an execution model:
 
+<!-- doc-test-declaration: split-before=RespireBatch batch -->
 ```csharp
 static void QueueUserUpdate(IRespireCommandQueue queue, string userId)
 {
diff --git a/website/docs/integrations/caching.md b/website/docs/integrations/caching.md
index 56fc3a205..b60e71f89 100644
--- a/website/docs/integrations/caching.md
+++ b/website/docs/integrations/caching.md
@@ -42,6 +42,7 @@ is set, it uses a separately registered `IRespireClient` without taking ownershi
 
 Inject the framework abstraction into application code:
 
+<!-- doc-test-declaration -->
 ```csharp
 public sealed class ProductCache(IDistributedCache cache)
 {
diff --git a/website/docs/integrations/dependency-injection.md b/website/docs/integrations/dependency-injection.md
index e17d9a0f1..f82f05901 100644
--- a/website/docs/integrations/dependency-injection.md
+++ b/website/docs/integrations/dependency-injection.md
@@ -25,6 +25,7 @@ builder.Services.AddRespire(
 
 Inject `IRespireClient`:
 
+<!-- doc-test-declaration -->
 ```csharp
 public sealed class SessionStore(IRespireClient redis)
 {
@@ -39,6 +40,7 @@ The container owns disposal.
 
 Use keyed services when an application talks to separate endpoints:
 
+<!-- doc-test-tail-declaration: split-before=public sealed class CartService -->
 ```csharp
 builder.Services.AddKeyedRespire("sessions", "redis://sessions-host");
 builder.Services.AddKeyedRespire("jobs", "redis://jobs-host");