From 99f46bcf905cf0b9e757a51b985fde666b325edd Mon Sep 17 00:00:00 2001
From: Xavier <1859710+xavierjohn@users.noreply.github.com>
Date: Thu, 18 Jun 2026 22:22:35 -0700
Subject: [PATCH] docs: add YAML front matter to the SLI API reference docs

The three docs/api_reference/trellis-api-sli*.md files used bold-markdown headers
instead of the YAML front matter (package / namespaces / types / version /
last_verified / audience: [llm]) that the Trellis framework reference docs use.
Tooling or LLMs that key off audience:[llm] or the types metadata skipped or
misclassified these docs relative to the rest of the Trellis reference set.

Prepend the standard front matter to all three (additive -- the human-readable
**Package** / **Namespace** / **Purpose** lines stay). The docs are auto-packed
into each package's trellis/ folder by Directory.Build.targets, so republished
packages carry the metadata for every downstream consumer (framework, templates,
future consumers).

Verified by packing Trellis.ServiceLevelIndicators: the trellis/trellis-api-sli.md
entry now begins with the front matter block.
---
 docs/api_reference/trellis-api-sli-apiversioning.md | 9 +++++++++
 docs/api_reference/trellis-api-sli-asp.md           | 9 +++++++++
 docs/api_reference/trellis-api-sli.md               | 9 +++++++++
 3 files changed, 27 insertions(+)

diff --git a/docs/api_reference/trellis-api-sli-apiversioning.md b/docs/api_reference/trellis-api-sli-apiversioning.md
index 0fef47b..2ff7ff8 100644
--- a/docs/api_reference/trellis-api-sli-apiversioning.md
+++ b/docs/api_reference/trellis-api-sli-apiversioning.md
@@ -1,3 +1,12 @@
+---
+package: Trellis.ServiceLevelIndicators.Asp.ApiVersioning
+namespaces: [Trellis.ServiceLevelIndicators]
+types: [ServiceLevelIndicatorServiceCollectionExtensions, ApiVersionEnrichment, AddApiVersion]
+version: v10
+last_verified: 2026-06-18
+audience: [llm]
+---
+
 # Trellis.ServiceLevelIndicators.Asp.ApiVersioning — API Reference
 
 **Package:** `Trellis.ServiceLevelIndicators.Asp.ApiVersioning`  
diff --git a/docs/api_reference/trellis-api-sli-asp.md b/docs/api_reference/trellis-api-sli-asp.md
index cc00a84..6d47fad 100644
--- a/docs/api_reference/trellis-api-sli-asp.md
+++ b/docs/api_reference/trellis-api-sli-asp.md
@@ -1,3 +1,12 @@
+---
+package: Trellis.ServiceLevelIndicators.Asp
+namespaces: [Trellis.ServiceLevelIndicators]
+types: [IServiceLevelIndicatorBuilder, ServiceLevelIndicatorCoreServiceCollectionExtensions, ServiceLevelIndicatorServiceCollectionExtensions, ServiceLevelIndicatorApplicationBuilderExtensions, EndpointBuilderExtensions, ServiceLevelIndicatorAttribute, CustomerResourceIdAttribute, MeasureAttribute, CustomerResourceIdMetadata, MeasureMetadata, WebEnrichmentContext, IServiceLevelIndicatorFeature, HttpContextExtensions]
+version: v10
+last_verified: 2026-06-18
+audience: [llm]
+---
+
 # Trellis.ServiceLevelIndicators.Asp — API Reference
 
 **Package:** `Trellis.ServiceLevelIndicators.Asp`  
diff --git a/docs/api_reference/trellis-api-sli.md b/docs/api_reference/trellis-api-sli.md
index f0fd659..f3eb990 100644
--- a/docs/api_reference/trellis-api-sli.md
+++ b/docs/api_reference/trellis-api-sli.md
@@ -1,3 +1,12 @@
+---
+package: Trellis.ServiceLevelIndicators
+namespaces: [Trellis.ServiceLevelIndicators]
+types: [ServiceLevelIndicator, ServiceLevelIndicatorOptions, MeasuredOperation, SliOutcome, IEnrichmentContext, "IEnrichment<T>", IServiceLevelIndicatorBuilder, ServiceLevelIndicatorMeterProviderBuilderExtensions, AddServiceLevelIndicator, AddServiceLevelIndicatorInstrumentation]
+version: v10
+last_verified: 2026-06-18
+audience: [llm]
+---
+
 # Trellis.ServiceLevelIndicators — API Reference
 
 **Package:** `Trellis.ServiceLevelIndicators`