Address PR review feedback

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: davidfowl

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

@@ -113,10 +113,44 @@ export const deploymentTopics: StarlightSidebarTopicsUserConfig = {
     },
     {
       label: 'Azure',
+      translations: {
+        da: 'Azure',
+        de: 'Azure',
+        en: 'Azure',
+        es: 'Azure',
+        fr: 'Azure',
+        hi: 'Azure',
+        id: 'Azure',
+        it: 'Azure',
+        ja: 'Azure',
+        ko: 'Azure',
+        'pt-BR': 'Azure',
+        ru: 'Azure',
+        tr: 'Azure',
+        uk: 'Azure',
+        'zh-CN': 'Azure',
+      },
       collapsed: false,
       items: [
         {
           label: 'Aspire CLI',
+          translations: {
+            da: 'Aspire CLI',
+            de: 'Aspire CLI',
+            en: 'Aspire CLI',
+            es: 'Aspire CLI',
+            fr: 'Aspire CLI',
+            hi: 'Aspire CLI',
+            id: 'Aspire CLI',
+            it: 'Aspire CLI',
+            ja: 'Aspire CLI',
+            ko: 'Aspire CLI',
+            'pt-BR': 'Aspire CLI',
+            ru: 'Aspire CLI',
+            tr: 'Aspire CLI',
+            uk: 'Aspire CLI',
+            'zh-CN': 'Aspire CLI',
+          },
           slug: 'deployment/azure/aca-deployment-aspire-cli',
         },
         {

src/frontend/src/components/TopicHero.astro

@@ -38,6 +38,14 @@ const accentVarMap: Record<NonNullable<Props['accent']>, string> = {
 
 const accentColor = accentVarMap[accent];
 const floatingIconConfigs = buildFloatingIconLayout(title, floatingIcons);
+const subtitleSegments = subtitle
+  .split(/(`[^`]+`)/g)
+  .filter((segment) => segment.length > 0)
+  .map((segment) =>
+    segment.startsWith('`') && segment.endsWith('`')
+      ? { kind: 'code' as const, text: segment.slice(1, -1) }
+      : { kind: 'text' as const, text: segment }
+  );
 ---
 
 <section class="topic-hero not-content" style={`--topic-accent: ${accentColor}`}>
@@ -54,7 +62,13 @@ const floatingIconConfigs = buildFloatingIconLayout(title, floatingIcons);
       {title}{' '}
       {highlight && <span class="topic-hero-highlight">{highlight}</span>}
     </h1>
-    <p class="topic-hero-subtitle">{subtitle}</p>
+    <p class="topic-hero-subtitle">
+      {
+        subtitleSegments.map((segment) =>
+          segment.kind === 'code' ? <code>{segment.text}</code> : segment.text
+        )
+      }
+    </p>
     {
       (primaryCta || secondaryCta) && (
         <div class="topic-hero-actions">

src/frontend/src/content/docs/deployment/index.mdx

@@ -22,7 +22,7 @@ import CTABanner from '@components/CTABanner.astro';
   icon="rocket"
   title="From dev to production,"
   highlight="seamlessly."
-  subtitle="Use aspire publish to emit deployment artifacts as a one-way handoff for external or manual use, or use aspire deploy to let Aspire generate, resolve, and apply changes directly."
+  subtitle="Use `aspire publish` to emit deployment artifacts as a one-way handoff for external or manual use, or use `aspire deploy` to let Aspire generate, resolve, and apply changes directly."
   accent="orange"
   floatingIcons={[
     'cloud-download',

src/frontend/src/content/docs/deployment/overview.mdx

@@ -30,7 +30,7 @@ builder.AddProject<Projects.Api>("api");
 
 builder.Build().Run();
 
-````
+```
 </TabItem>
 <TabItem id='typescript' label='TypeScript'>
 ```typescript title="apphost.ts"
@@ -43,7 +43,7 @@ await builder.addDockerComposeEnvironment('env');
 await builder.addProject('api', '../Api/Api.csproj', 'http');
 
 await builder.build().run();
-````
+```
 
 </TabItem>
 </Tabs>
@@ -65,7 +65,7 @@ A pipeline step is a named unit of work in the Aspire pipeline. Any resource can
 | [`aspire deploy`](/reference/cli/commands/aspire-deploy/)   | The deploy entry point            | Generate target-specific output, resolve parameters, and apply deployment changes directly |
 | [`aspire do <step>`](/reference/cli/commands/aspire-do/)    | A named step and its dependencies | Run a specific step directly                                                               |
 
-If no resource contributes work for a given entry point, Aspire can still run the pipeline successfully as a no-op. That usually means your AppHost hasn't added a target or other resource that contributes steps for that path yet.
+If no resource contributes work for `publish` or `deploy`, Aspire has nothing to execute for that entry point. In current Aspire CLI builds, that entry point completes as a no-op. That usually means your AppHost hasn't added a target or other resource that contributes steps for that path yet.
 
 These are separate entry points. Use `aspire publish` when you want a one-way handoff out of Aspire: it emits artifacts that another tool or a manual step will apply later. Use `aspire deploy` when you want Aspire to stay in control, generate the target-specific output behind the scenes, resolve parameter values, and apply the deployment in one operation. `aspire deploy` does not consume previously published assets.
 
@@ -104,11 +104,11 @@ var apiKey = builder.AddParameter("apiKey", secret: true);
 builder.AddDockerComposeEnvironment("env");
 
 builder.AddProject<Projects.Api>("api")
-.WithEnvironment("API_KEY", apiKey);
+    .WithEnvironment("API_KEY", apiKey);
 
 builder.Build().Run();
 
-````
+```
 </TabItem>
 <TabItem id='typescript' label='TypeScript'>
 ```typescript title="apphost.ts"
@@ -123,7 +123,7 @@ const api = await builder.addProject('api', '../Api/Api.csproj', 'http');
 await api.withEnvironment('API_KEY', apiKey);
 
 await builder.build().run();
-````
+```
 
 </TabItem>
 </Tabs>
@@ -133,6 +133,7 @@ In this example:
 - `apiKey` is the Aspire parameter name in the AppHost.
 - `API_KEY` is the environment variable the deployed app receives.
 - `Parameters__apiKey` is an environment variable you can use to supply the value to the AppHost when the pipeline runs.
+- `APIKEY` is the publish-time placeholder name Docker Compose emits in generated `.env` and `${...}` references.
 
 When the Docker Compose target publishes artifacts, the publish path preserves that relationship in target-specific output:
 
@@ -149,6 +150,8 @@ services:
 APIKEY=
 ```
 
+In this Docker Compose output, the placeholder name is `APIKEY` rather than `API_KEY`. The app still receives `API_KEY`; `APIKEY` is only the generated publish-time placeholder that the emitted artifacts use later.
+
 The placeholder name in published output is target-specific, but the mapping stays the same:
 
 | Stage              | Example                | Meaning                                                                 |

src/frontend/tests/unit/custom-components.vitest.test.ts

@@ -305,18 +305,25 @@ const basicRenderCases: BasicRenderCase[] = [
     includes: ['Build', 'faster', 'Get started', '/get-started/', 'Docs'],
   },
   {
-    name: 'TopicHero renders optional CTAs and floating icons',
+    name: 'TopicHero renders optional CTAs, floating icons, and inline code in subtitles',
     Component: TopicHero,
     props: {
       title: 'Platform',
       highlight: 'overview',
-      subtitle: 'Understand the building blocks.',
+      subtitle: 'Use `aspire publish` for handoff.',
       primaryCta: { label: 'Explore', href: '/docs/' },
       secondaryCta: { label: 'Deploy', href: '/deployment/' },
       icon: 'rocket',
       floatingIcons: ['open-book', 'puzzle'],
     },
-    includes: ['Platform', 'overview', 'Explore', '/deployment/', 'floating-icon'],
+    includes: [
+      'Platform',
+      'overview',
+      'Explore',
+      '/deployment/',
+      'floating-icon',
+      '>aspire publish</code>',
+    ],
   },
   {
     name: 'ThemeImage renders light and dark sources',