From f655090d4ced93f4f6f0825bd6c8cd6a5f9836ce Mon Sep 17 00:00:00 2001
From: "aspire-repo-bot[bot]"
 <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Date: Wed, 12 Aug 2026 05:24:53 +0000
Subject: [PATCH 1/2] docs: note WithTerminal Columns/Rows validation

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 src/frontend/src/content/docs/app-host/with-terminal.mdx | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/frontend/src/content/docs/app-host/with-terminal.mdx b/src/frontend/src/content/docs/app-host/with-terminal.mdx
index 1e65c6147..462b3d68b 100644
--- a/src/frontend/src/content/docs/app-host/with-terminal.mdx
+++ b/src/frontend/src/content/docs/app-host/with-terminal.mdx
@@ -77,6 +77,10 @@ The terminal session is described by a set of options with sensible defaults:
 | `Shell`             | `null`  | The shell to launch for the session. When `null`, the default is used: for containers this is typically `/bin/sh`; for executables the process itself is the terminal program. |
 | `ShowTerminalHost`  | `false` | Whether the hidden per-replica terminal host resources appear in the dashboard and CLI resource lists. Set to `true` to diagnose terminal-host startup or connectivity issues. |
 
+<Aside type="note">
+`Columns` and `Rows` must each be `1` or greater. Setting either to zero or a negative value throws an `ArgumentOutOfRangeException` immediately when you set the option, rather than surfacing later as an opaque terminal-host startup failure.
+</Aside>
+
 <Tabs syncKey='aspire-lang'>
 <TabItem id='csharp' label='C#'>
 

From 707c5f18d07d3e39ca88acd2428539f05a4c0741 Mon Sep 17 00:00:00 2001
From: David Pine <7679720+IEvangelist@users.noreply.github.com>
Date: Wed, 12 Aug 2026 09:11:19 -0500
Subject: [PATCH 2/2] Clarify terminal dimension validation wording

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

Copilot-Session: 32c349b4-907d-42e9-aad8-2f0edc267779
---
 src/frontend/src/content/docs/app-host/with-terminal.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/frontend/src/content/docs/app-host/with-terminal.mdx b/src/frontend/src/content/docs/app-host/with-terminal.mdx
index 462b3d68b..9daf9b57a 100644
--- a/src/frontend/src/content/docs/app-host/with-terminal.mdx
+++ b/src/frontend/src/content/docs/app-host/with-terminal.mdx
@@ -78,7 +78,7 @@ The terminal session is described by a set of options with sensible defaults:
 | `ShowTerminalHost`  | `false` | Whether the hidden per-replica terminal host resources appear in the dashboard and CLI resource lists. Set to `true` to diagnose terminal-host startup or connectivity issues. |
 
 <Aside type="note">
-`Columns` and `Rows` must each be `1` or greater. Setting either to zero or a negative value throws an `ArgumentOutOfRangeException` immediately when you set the option, rather than surfacing later as an opaque terminal-host startup failure.
+`Columns` and `Rows` must each be `1` or greater. Configuring either with zero or a negative value in the `WithTerminal(...)` callback throws an `ArgumentOutOfRangeException` immediately instead of failing later during terminal-host startup.
 </Aside>
 
 <Tabs syncKey='aspire-lang'>