docs: add YAML front matter to the SLI API reference docs

[xavierjohn]

Summary

The three SLI API reference docs (docs/api_reference/trellis-api-sli*.md) used bold-markdown headers (**Package:**, **Namespace:**, **Purpose:**) instead of the YAML front matter that the Trellis framework reference docs use. Any tooling/LLM indexing that keys off audience: [llm] or the types: metadata would skip or misclassify these three docs relative to the rest of the Trellis reference set.

Change

Prepend the standard front matter to all three docs — additive only, the human-readable **Package** / **Namespace** / **Purpose** lines stay:

---
package: Trellis.ServiceLevelIndicators
namespaces: [Trellis.ServiceLevelIndicators]
types: [ServiceLevelIndicator, ServiceLevelIndicatorOptions, ...]
version: v10
last_verified: 2026-06-18
audience: [llm]
---

types lists are extracted from each doc's ### Type sections. Repo convention preserved (UTF-8 no-BOM, CRLF).

Why this is the right layer

docs/api_reference/ is the single source — Directory.Build.targets auto-packs each trellis-api-<TrellisApiRefName>.md into the package's trellis/ folder. So a republish flows the metadata to every downstream consumer (the framework, both dotnet new templates, and any future consumer) instead of being patched per-repo.

Verification

Packed Trellis.ServiceLevelIndicators locally — the trellis/trellis-api-sli.md entry inside the .nupkg now begins with the front matter block. Docs-only change; no code or test impact.

Note: version: v10 mirrors the framework's v3 (major-version line) for the SLI 10.x packages — change if a different convention is preferred.

[github-actions]

Test Results

99 tests  ±0   99 ✅ ±0   17s ⏱️ +5s
 3 suites ±0    0 💤 ±0 
 3 files   ±0    0 ❌ ±0 

Results for commit 99f46bc. ± Comparison against base commit 88fcdc5.

[Copilot]

⚠️ Not ready to approve

The new types front matter appears inconsistent with the docs’ actual ### type sections (includes non-type headings/method names), which undermines the indexing goal of the change.

Pull request overview

This PR updates the API reference markdown in docs/api_reference/ to align with Trellis reference-doc conventions by adding YAML front matter (e.g., package, namespaces, types, version, last_verified, audience) while preserving the existing human-readable **Package:** / **Namespace:** / **Purpose:** headers.

Changes:

• Added standard YAML front matter blocks to the core SLI, ASP integration, and API versioning reference docs.
• Introduced types metadata intended to reflect each doc’s documented API surface for indexing/tooling.

File summaries

File	Description
docs/api_reference/trellis-api-sli.md	Adds YAML front matter for the core SLI package API reference.
docs/api_reference/trellis-api-sli-asp.md	Adds YAML front matter for the ASP.NET Core integration API reference.
docs/api_reference/trellis-api-sli-apiversioning.md	Adds YAML front matter for the API versioning integration API reference.

Copilot's findings

• Files reviewed: 3/3 changed files
• Comments generated: 2

Note

Your feedback helps us improve the quality of this feature.
Please use 👍 or 👎 to tell us whether this assessment is correct.

[xavierjohn]

Good catch -- addressed in follow-up #62. Tightened types: to each doc's actual ### type sections: dropped method names and types whose sections live in a sibling doc (e.g. SliOutcome / IServiceLevelIndicatorBuilder here, AddApiVersion in the api-versioning doc).

[xavierjohn]

Good catch -- addressed in follow-up #62. Tightened types: to each doc's actual ### type sections: dropped method names and types whose sections live in a sibling doc (e.g. SliOutcome / IServiceLevelIndicatorBuilder here, AddApiVersion in the api-versioning doc).