From 3631a136b2cab82ad4f87e3de6c7b5072103b702 Mon Sep 17 00:00:00 2001
From: Kieron Lanning <kieronlanning@users.noreply.github.com>
Date: Thu, 24 Sep 2026 17:13:46 +0100
Subject: [PATCH 1/2] fix: xml comment

---
 Directory.Packages.props |  4 ++--
 docs/wiki/index.md       |  6 ++++++
 mkdocs.yml               | 32 ++++++++++++++++++++++++++++++++
 package.json             |  2 +-
 4 files changed, 41 insertions(+), 3 deletions(-)
 create mode 100644 docs/wiki/index.md
 create mode 100644 mkdocs.yml

diff --git a/Directory.Packages.props b/Directory.Packages.props
index c614582..d4f7441 100644
--- a/Directory.Packages.props
+++ b/Directory.Packages.props
@@ -3,8 +3,8 @@
 		<ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
 		<RoslynVersion>5.9.0</RoslynVersion>
 		<TUnitVersion>1.68.17</TUnitVersion>
-		<PurviewSourceGeneratorFrameworkVersion>1.0.0-prerelease.49</PurviewSourceGeneratorFrameworkVersion>
-		<PurviewTelemetryVersion>5.0.0-prerelease.14</PurviewTelemetryVersion>
+		<PurviewSourceGeneratorFrameworkVersion>1.0.0-prerelease.50</PurviewSourceGeneratorFrameworkVersion>
+		<PurviewTelemetryVersion>5.0.0-prerelease.15</PurviewTelemetryVersion>
 		<DotNetRuntimeVersion>10.0.12</DotNetRuntimeVersion>
 		<MSExtensionVersion>10.10.0</MSExtensionVersion>
 		<OTelVersion>1.19.0</OTelVersion>
diff --git a/docs/wiki/index.md b/docs/wiki/index.md
new file mode 100644
index 0000000..45e6375
--- /dev/null
+++ b/docs/wiki/index.md
@@ -0,0 +1,6 @@
+# Aspire ResourceKit
+
+Build strongly typed .NET Aspire resources with source-generated configuration and lifecycle support.
+
+[Documentation overview](Home.md){ .md-button .md-button--primary }
+[Get started](Getting-Started.md){ .md-button }
diff --git a/mkdocs.yml b/mkdocs.yml
new file mode 100644
index 0000000..3c6d5d8
--- /dev/null
+++ b/mkdocs.yml
@@ -0,0 +1,32 @@
+site_name: Aspire ResourceKit
+site_description: Developer documentation for Aspire ResourceKit
+repo_url: https://github.com/purview-dev/aspire-resourcekit
+edit_uri: edit/main/docs/wiki/
+docs_dir: docs/wiki
+theme:
+  name: material
+  palette:
+    - media: '(prefers-color-scheme: light)'
+      scheme: default
+      primary: indigo
+      accent: cyan
+    - media: '(prefers-color-scheme: dark)'
+      scheme: slate
+      primary: indigo
+      accent: cyan
+  features:
+    - navigation.instant
+    - navigation.sections
+    - navigation.top
+    - search.highlight
+    - search.suggest
+    - content.code.copy
+plugins:
+  - search
+  - techdocs-core
+markdown_extensions:
+  - admonition
+  - attr_list
+  - md_in_html
+  - pymdownx.details
+  - pymdownx.superfences
diff --git a/package.json b/package.json
index 7c329d3..3f24e0c 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
 	"name": "purview-aspire-resourcekit",
-	"version": "1.0.0-prerelease.36",
+	"version": "1.0.0-prerelease.37",
 	"keywords": [],
 	"homepage": "https://purview.dev/projects/aspire-resourcekit/",
 	"bugs": {

From d2066f2791fdc0419ac8749119a9dbeacffac7ce Mon Sep 17 00:00:00 2001
From: Kieron Lanning <kieronlanning@users.noreply.github.com>
Date: Thu, 24 Sep 2026 17:19:09 +0100
Subject: [PATCH 2/2] fix: xml comment

---
 src/src/SourceGeneration/Helpers/ResourceKitRules.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/src/SourceGeneration/Helpers/ResourceKitRules.cs b/src/src/SourceGeneration/Helpers/ResourceKitRules.cs
index f32212c..41bcf48 100644
--- a/src/src/SourceGeneration/Helpers/ResourceKitRules.cs
+++ b/src/src/SourceGeneration/Helpers/ResourceKitRules.cs
@@ -43,8 +43,8 @@ static class ResourceKitRules
 	);
 
 	/// <summary>
-	/// A neutral rule evaluation that can be converted into either a <see cref="ReportableDiagnostic"/> (for the
-	/// generator's incremental model) or a Roslyn <see cref="Diagnostic"/> (for the analyzer).
+	/// A neutral rule evaluation that can be converted into either a <c>ReportableDiagnostic</c> (for the generator's
+	/// incremental model) or a Roslyn <see cref="Diagnostic"/> (for the analyzer).
 	/// </summary>
 	internal readonly record struct RuleEvaluation(
 		DiagnosticDescriptor Descriptor,