Merge main into release/13.5

.devcontainer/devcontainer.json

@@ -6,6 +6,9 @@
       "version": "10.28.0"
     }
   },
+  "containerEnv": {
+    "ASTRO_TELEMETRY_DISABLED": "1"
+  },
   "customizations": {
     "codespaces": {
       "openFiles": [

.github/astro.instructions.md

@@ -93,6 +93,7 @@ The site uses these Starlight plugins (configured in `astro.config.mjs`):
 
 Custom overrides live in `src/components/starlight/` and are registered in `astro.config.mjs` under `components:`:
 
+- `Banner.astro` — dismissible announcement banner (content hashed for a stable dismiss key). Supports declarative auto-expiry via two optional **top-level** frontmatter fields: `bannerExpiresOn` (a `YYYY-MM-DD` sunset date that hides it for everyone; a past date drops it at build time) and `bannerAutoDismissAfterDays` (a per-reader window that auto-hides it N days after they first see it, tracked in `localStorage`). These are top-level (not nested under `banner`) because extra keys nested inside Starlight's built-in `banner` object are stripped before reaching the component. Pure decision logic lives in `src/utils/banner-expiry.ts` and is **imported directly** by the client script (single source of truth — the shipped behavior can't diverge from the unit tests).
 - `EditLink.astro` — adds translation link
 - `Footer.astro` — custom 4-column footer layout
 - `Head.astro` — git metadata, auto-language detection, accessibility
@@ -122,7 +123,7 @@ Always follow existing component patterns: `.astro` files with frontmatter props
 
 Defined in `src/content.config.ts`:
 
-- **docs** — uses Starlight's docs loader with extended schema fields: `renderBlocking`, `giscus`, `category`, `pageActions`
+- **docs** — uses Starlight's docs loader with extended schema fields: `renderBlocking`, `giscus`, `category`, `pageActions`, and top-level banner auto-expiry fields (`bannerExpiresOn`, `bannerAutoDismissAfterDays`)
 - **i18n** — Starlight i18n loader for 15 locales
 - **packages** — auto-generated API reference JSON from `src/data/pkgs/`
 

.github/forbidden-words.json

@@ -18,6 +18,11 @@
       "replacement": "Aspire",
       "message": "Use \"Aspire\" instead of \"dotnet aspire\"."
     },
+    {
+      "pattern": "(?<=polyglot )\\bapp hosts\\b",
+      "replacement": "AppHosts",
+      "message": "Use \"polyglot AppHosts\" instead of \"polyglot app hosts\"."
+    },
     {
       "pattern": "\\bapp host\\b",
       "replacement": "AppHost",

.github/workflows/update-integration-data.yml

@@ -211,6 +211,7 @@ jobs:
             echo "- Changed: \`${{ steps.update.outputs.changed || 'unknown' }}\`"
             echo "- Versions changed: \`${{ steps.update.outputs.versions_changed || 'n/a' }}\`"
             echo "- API regen ran: \`${{ steps.update.outputs.regen_ran || 'n/a' }}\`"
+            echo "- Semantic validation: \`${{ steps.update.outputs.semantic_validation || 'not run' }}\`"
             if [ -n "${{ steps.update.outputs.icon_warnings }}" ]; then
               echo "- Icon warnings: \`${{ steps.update.outputs.icon_warnings }}\`"
             fi

src/frontend/config/sidebar/docs.topics.ts

@@ -628,6 +628,27 @@ export const docsTopics: StarlightSidebarTopicsUserConfig = {
               },
               slug: 'fundamentals/service-discovery',
             },
+            {
+              label: 'Environment variables',
+              slug: 'fundamentals/environment-variables',
+              translations: {
+                da: 'Miljøvariabler',
+                de: 'Umgebungsvariablen',
+                en: 'Environment variables',
+                es: 'Variables de entorno',
+                fr: "Variables d'environnement",
+                hi: 'पर्यावरण चर',
+                id: 'Variabel lingkungan',
+                it: 'Variabili di ambiente',
+                ja: '環境変数',
+                ko: '환경 변수',
+                'pt-BR': 'Variáveis de ambiente',
+                ru: 'Переменные среды',
+                tr: 'Ortam değişkenleri',
+                uk: 'Змінні середовища',
+                'zh-CN': '环境变量',
+              },
+            },
             {
               label: 'Networking overview',
               slug: 'fundamentals/networking-overview',

src/frontend/package.json

@@ -55,7 +55,8 @@
     "update:ts-api": "tsx ./scripts/update-ts-api.ts",
     "update:github-stats": "tsx ./scripts/update-github-stats.ts",
     "update:samples": "tsx ./scripts/update-samples.ts",
-    "normalize:api-data": "tsx ./scripts/normalize-generated-api-data.ts"
+    "normalize:api-data": "tsx ./scripts/normalize-generated-api-data.ts",
+    "validate:api-data": "tsx ./scripts/validate-generated-api-data.ts"
   },
   "dependencies": {
     "@astro-community/astro-embed-vimeo": "^0.3.12",
@@ -81,7 +82,7 @@
     "astro-tooltips": "^0.6.2",
     "hast-util-to-html": "^9.0.5",
     "mdast-util-to-hast": "^13.2.1",
-    "mermaid": "^11.16.0",
+    "mermaid": "^11.16.1",
     "remark-directive": "^4.0.0",
     "satori": "^0.28.1",
     "satteri": "^0.9.5",