From e74d4e89fada2015107c16819219dffb10feaf34 Mon Sep 17 00:00:00 2001
From: "aspire-repo-bot[bot]"
 <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Date: Mon, 18 May 2026 16:36:43 +0000
Subject: [PATCH] docs: add polyglot WithComputeEnvironment examples to
 Kubernetes and Docker integration pages

WithComputeEnvironment is now available in polyglot (TypeScript, Python, Java, Go) app hosts
as of microsoft/aspire#17093. Expand the existing tip asides on the Kubernetes and Docker
integration pages to include C# and TypeScript code examples showing how to call the API.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 .../docs/integrations/compute/docker.mdx      | 26 ++++++++++++++++---
 .../docs/integrations/compute/kubernetes.mdx  | 26 ++++++++++++++++---
 2 files changed, 46 insertions(+), 6 deletions(-)

diff --git a/src/frontend/src/content/docs/integrations/compute/docker.mdx b/src/frontend/src/content/docs/integrations/compute/docker.mdx
index 56b6833b5..10411863b 100644
--- a/src/frontend/src/content/docs/integrations/compute/docker.mdx
+++ b/src/frontend/src/content/docs/integrations/compute/docker.mdx
@@ -142,9 +142,29 @@ The preceding code:
 When a Docker Compose environment is present, all resources are automatically published as Docker Compose services — no additional opt-in is required.
 
 <Aside type="tip">
-  With the `compose` variable assigned, you can pass that to the
-  `WithComputeEnvironment` API to disambiguate compute resources for solutions
-  that define more than one. Otherwise, the `compose` variable isn't required.
+  With the `compose` variable assigned, you can pass it to the `WithComputeEnvironment` API to
+  disambiguate compute resources for solutions that define more than one. Otherwise, the `compose`
+  variable isn't required. This API is available in C# and polyglot (TypeScript, Python, Java,
+  Go) app hosts.
+
+  <Tabs syncKey='aspire-lang'>
+  <TabItem id='csharp' label='C#'>
+  ```csharp title="AppHost.cs"
+  var compose = builder.AddDockerComposeEnvironment("compose");
+
+  builder.AddProject<Projects.MyApi>("api")
+         .WithComputeEnvironment(compose);
+  ```
+  </TabItem>
+  <TabItem id='typescript' label='TypeScript'>
+  ```typescript title="apphost.ts"
+  const compose = await builder.addDockerComposeEnvironment("compose");
+
+  const api = await builder.addContainer("api", "nginx:alpine");
+  await api.withComputeEnvironment(compose);
+  ```
+  </TabItem>
+  </Tabs>
 </Aside>
 
 ### Add Docker Compose environment resource with properties
diff --git a/src/frontend/src/content/docs/integrations/compute/kubernetes.mdx b/src/frontend/src/content/docs/integrations/compute/kubernetes.mdx
index 4a12e81be..7c5f7017f 100644
--- a/src/frontend/src/content/docs/integrations/compute/kubernetes.mdx
+++ b/src/frontend/src/content/docs/integrations/compute/kubernetes.mdx
@@ -107,9 +107,29 @@ await builder.build().run();
 </Tabs>
 
 <Aside type="tip">
-  With the `k8s` variable assigned, you can pass that to the
-  `WithComputeEnvironment` API to disambiguate compute resources for solutions
-  that define more than one. Otherwise, the `k8s` variable isn't required.
+  With the `k8s` variable assigned, you can pass it to the `WithComputeEnvironment` API to
+  disambiguate compute resources for solutions that define more than one. Otherwise, the `k8s`
+  variable isn't required. This API is available in C# and polyglot (TypeScript, Python, Java,
+  Go) app hosts.
+
+  <Tabs syncKey="aspire-lang">
+  <TabItem id="csharp" label="C#">
+  ```csharp title="AppHost.cs"
+  var k8s = builder.AddKubernetesEnvironment("k8s");
+
+  builder.AddProject<Projects.MyApi>("api")
+         .WithComputeEnvironment(k8s);
+  ```
+  </TabItem>
+  <TabItem id="typescript" label="TypeScript">
+  ```typescript title="apphost.ts"
+  const k8s = await builder.addKubernetesEnvironment('k8s');
+
+  const api = await builder.addNodeApp('api', './api', 'src/index.ts');
+  await api.withComputeEnvironment(k8s);
+  ```
+  </TabItem>
+  </Tabs>
 </Aside>
 
 ## Configure Helm chart options