Merge branch 'main' into eric/remove-hello-bar-634

Author: maartenba

.fleet/run.json

@@ -26,7 +26,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '22'
+          node-version: '24'
 
       - name: Build container
         run: dotnet build.cs container

.github/workflows/ci.yml

@@ -28,7 +28,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '22'
+          node-version: '24'
 
       - name: Build Astro
         run: dotnet build.cs astro-build

.github/workflows/link-checker.yml

@@ -6,7 +6,7 @@ Welcome to the documentation of all [Duende Software](https://duendesoftware.com
 
 You will need the following installed:
 * [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0)
-* Node.js 22+
+* Node.js 24+
 
 ### Quick Start (Astro only)
 
@@ -216,6 +216,25 @@ redirects: {
 This will remove the old page from the navigation structure, but keeps the URL around
 with a redirect to the new location.
 
+## 🤖 AI-Friendly Documentation
+
+We make our docs consumable by AI agents and LLMs, not just humans.
+
+### What we do
+
+* **[`llms.txt`](https://docs.duendesoftware.com/llms.txt) and [`llms-full.txt`](https://docs.duendesoftware.com/llms-full.txt)** — Machine-readable site index and full content dump following the [llms.txt proposal](https://llmstxt.org/), so AI tools can discover and ingest our docs.
+* **Content negotiation** — The server supports `Accept: text/markdown` to return raw Markdown for any docs page, giving AI agents clean content without HTML noise.
+* **`robots.txt` signals** — We don't block AI crawlers. The robots.txt includes references to `llms.txt` so crawlers can find structured content.
+
+Beyond this repo, Duende also provides tools that give AI coding assistants specialized knowledge (see [AI Agent Tools](https://docs.duendesoftware.com/general/ai-agent-tools/)):
+
+* **[Agent Skills](https://github.com/DuendeSoftware/duende-skills)** — Structured `SKILL.md` files following the [Agent Skills format](https://agentskills.io/) that give AI assistants domain expertise on IdentityServer, BFF, token management, and more. Loaded automatically by compatible IDEs.
+* **[MCP Server](https://github.com/DuendeSoftware/products/blob/main/docs-mcp/README.md)** — A local [Model Context Protocol](https://modelcontextprotocol.io/) server that gives AI assistants search and fetch access to the full Duende docs, blog, and sample code via SQLite full-text search.
+
+### Why
+
+Developers increasingly use AI assistants to find answers. If our docs aren't AI-friendly, those assistants hallucinate or point elsewhere. Making content machine-readable means Duende products get accurate representation in AI-generated answers.
+
 ## ⚖️ License
 
 For all licensing information, refer to the relevant license files:

README.md

@@ -1,5 +1,5 @@
 {
-  "image": "mcr.microsoft.com/devcontainers/typescript-node:22",
+  "image": "mcr.microsoft.com/devcontainers/typescript-node:24",
   "customizations": {
     "vscode": {
       "extensions": [

astro/.devcontainer.json

@@ -0,0 +1,6 @@
+# @pasqal-io/starlight-client-mermaid@0.1.0 has a stale peer dep on
+# @astrojs/markdown-remark@^6.0.2 which conflicts with the ^7.1.0 required
+# by Astro 6 / Starlight 0.38. The package works fine at runtime.
+# Remove this once starlight-client-mermaid publishes a version with an
+# updated peer dependency range.
+legacy-peer-deps=true

astro/.npmrc

@@ -17,24 +17,23 @@ import * as fs from "node:fs";
 import { duendeOpenGraphImage } from "./src/plugins/duende-og-image.js";
 import removeMarkdownExtensions from "./src/plugins/remove-markdown-extensions.js";
 import staticRedirects from "./src/plugins/static-redirects.js";
+import markdownOutput from "./src/plugins/markdown-output.js";
 
 // https://astro.build/config
 export default defineConfig({
   site: "https://docs.duendesoftware.com",
   trailingSlash: "ignore",
   redirects: {},
-  experimental: {
-    fonts: [
-      {
-        provider: fontProviders.google(),
-        name: "Roboto",
-        cssVariable: "--font-roboto",
-        weights: ["100 900", "bold"],
-        styles: ["normal", "italic"],
-        display: "swap",
-      },
-    ],
-  },
+  fonts: [
+    {
+      provider: fontProviders.google(),
+      name: "Roboto",
+      cssVariable: "--font-roboto",
+      weights: ["100 900", "bold"],
+      styles: ["normal", "italic"],
+      display: "swap",
+    },
+  ],
   integrations: [
     starlight({
       customCss: ["./src/styles/custom.css"],
@@ -235,6 +234,7 @@ export default defineConfig({
       contentDir: "./src/content/docs",
     }),
     staticRedirects(),
+    markdownOutput(),
     opengraphImages({
       options: {
         fonts: [