Document contextual endpoint resolution APIs for Aspire 13.2

.gitignore

@@ -18,6 +18,8 @@ dist/
 .astro/
 .cache/
 
+.netlify/
+
 # Logs
 npm-debug.log*
 yarn-debug.log*

.vscode/settings.json

@@ -1,27 +1,27 @@
 {
   "prettier.documentSelectors": ["**/*.astro"],
   "[astro]": {
-    "editor.defaultFormatter": "prettier.prettier-vscode"
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
   },
   "[typescript]": {
-    "editor.defaultFormatter": "prettier.prettier-vscode"
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
   },
   "[javascript]": {
-    "editor.defaultFormatter": "prettier.prettier-vscode"
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
   },
   "[markdown]": {
-    "editor.defaultFormatter": "prettier.prettier-vscode"
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
   },
   "[mdx]": {
-    "editor.defaultFormatter": "prettier.prettier-vscode"
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
   },
   "[json]": {
-    "editor.defaultFormatter": "prettier.prettier-vscode"
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
   },
   "[javascriptreact]": {
-    "editor.defaultFormatter": "prettier.prettier-vscode"
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
   },
   "[yaml]": {
-    "editor.defaultFormatter": "prettier.prettier-vscode"
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
   }
 }

CONTRIBUTING.md

@@ -6,6 +6,10 @@ Thank you for your interest in contributing to the aspire.dev! This guide will h
 
 Please see the full [Contributor guide](https://aspire.dev/community/contributor-guide/) for detailed instructions on how to contribute to aspire.dev, including guidelines for submitting issues, making pull requests, and coding standards.
 
+## Help translate the docs
+
+We welcome translation contributions! Please see our [Translation guide](https://aspire.dev/community/translation-guide/) to learn how to help translate aspire.dev into other languages. You can check the [translation status dashboard](https://aspire.dev/i18n/) to see what needs to be translated or updated.
+
 ## 🏗️ Project structure
 
 ```text

src/frontend/astro.config.mjs

@@ -39,7 +39,7 @@ export default defineConfig({
       locales,
       logo: {
         src: './src/assets/aspire-logo-32.svg',
-        replacesTitle: true,
+        replacesTitle: false,
       },
       editLink: {
         baseUrl: 'https://github.com/microsoft/aspire.dev/edit/main/src/frontend/',
@@ -82,7 +82,7 @@ export default defineConfig({
               claude: {
                 label: 'Open in Claude',
                 href: 'https://claude.ai/new?q=',
-              }
+              },
             },
           },
         }),
@@ -99,6 +99,9 @@ export default defineConfig({
               starlightLinksValidator({
                 errorOnRelativeLinks: false,
                 errorOnFallbackPages: false,
+                exclude: [
+                  '/i18n/'
+                ]
               }),
             ]
           : []),
@@ -165,6 +168,7 @@ export default defineConfig({
           showCaptions: true,
         }),
         starlightKbd({
+          globalPicker: false, // We manually place the picker in the footer preferences
           types: [
             { id: 'mac', label: 'macOS', detector: 'apple' },
             { id: 'windows', label: 'Windows', detector: 'windows', default: true },

src/frontend/config/head.attrs.ts

@@ -56,7 +56,7 @@ export const headAttrs: HeadAttr[] = [
     attrs: {
       name: 'twitter:description',
       content:
-        'Aspire (formerly .NET Aspire) streamlines your development workflow with code-first control, modularity, and observability.',
+        'Aspire streamlines your development workflow with code-first control, modularity, and observability.',
     },
   },
   { tag: 'meta', attrs: { name: 'twitter:image', content: 'https://aspire.dev/og-image.png' } },

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

@@ -91,6 +91,29 @@ export const communityTopics: StarlightSidebarTopicsUserConfig = {
           },
           slug: 'community/contributor-guide',
         },
+        {
+          label: 'Translation guide',
+          translations: {
+            da: 'Oversættelsesvejledning',
+            de: 'Übersetzungsleitfaden',
+            en: 'Translation guide',
+            es: 'Guía de traducción',
+            fr: 'Guide de traduction',
+            hi: 'अनुवाद गाइड',
+            id: 'Panduan terjemahan',
+            it: 'Guida alla traduzione',
+            ja: '翻訳ガイド',
+            ko: '번역 가이드',
+            pt: 'Guia de tradução',
+            'pt-BR': 'Guia de tradução',
+            'pt-PT': 'Guia de tradução',
+            ru: 'Руководство по переводу',
+            tr: 'Çeviri kılavuzu',
+            uk: 'Посібник з перекладу',
+            'zh-CN': '翻译指南',
+          },
+          slug: 'community/translation-guide',
+        },
       ],
     },
     {

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

@@ -26,6 +26,7 @@ export const diagnosticTopics: StarlightSidebarTopicsUserConfig = {
     { label: 'Overview', link: '/diagnostics/overview' },
     {
       label: 'Warnings',
+      collapsed: true,
       items: [
         { label: 'ASPIRE001', link: '/diagnostics/aspire001' },
         { label: 'ASPIRE002', link: '/diagnostics/aspire002' },
@@ -47,10 +48,22 @@ export const diagnosticTopics: StarlightSidebarTopicsUserConfig = {
           label: 'ASPIRECONTAINERRUNTIME001',
           link: '/diagnostics/aspirecontainerruntime001',
         },
+        {
+          label: 'ASPIRECONTAINERSHELLEXECUTION001',
+          link: '/diagnostics/aspirecontainershellexecution001',
+        },
         {
           label: 'ASPIREDOCKERFILEBUILDER001',
           link: '/diagnostics/aspiredockerfilebuilder001',
         },
+        {
+          label: 'ASPIREDOTNETTOOL',
+          link: '/diagnostics/aspiredotnettool',
+        },
+        {
+          label: 'ASPIREEXTENSION001',
+          link: '/diagnostics/aspireextension001',
+        },
         {
           label: 'ASPIREFILESYSTEM001',
           link: '/diagnostics/aspirefilesystem001',
@@ -67,6 +80,10 @@ export const diagnosticTopics: StarlightSidebarTopicsUserConfig = {
           label: 'ASPIREPROBES001',
           link: '/diagnostics/aspireprobes001',
         },
+        {
+          label: 'ASPIREPOSTGRES001',
+          link: '/diagnostics/aspirepostgres001',
+        },
         {
           label: 'ASPIREUSERSECRETS001',
           link: '/diagnostics/aspireusersecrets001',