From f0cd7bed81002c9c823d0f23846088f6c60207e3 Mon Sep 17 00:00:00 2001
From: Zhangyi Yuan <j-zhangyiyuan@microsoft.com>
Date: Tue, 11 Aug 2026 18:03:05 +0800
Subject: [PATCH] docs: note the minimum language runtimes in the bundled CLI
 quick start

The quick start jumps straight to code with no version requirements. On a Python older than the declared 3.11 floor, pip resolves to an outdated SDK release instead of reporting the conflict, so the snippet fails with an error that says nothing about the Python version.

Fixes #2293.
---
 docs/setup/bundled-cli.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/setup/bundled-cli.md b/docs/setup/bundled-cli.md
index f067de8fd..7e94c82fd 100644
--- a/docs/setup/bundled-cli.md
+++ b/docs/setup/bundled-cli.md
@@ -39,6 +39,9 @@ flowchart TB
 
 ## Quick start
 
+> [!NOTE]
+> Each SDK requires a minimum language runtime: **Node.js** 20+, **Python** 3.11+, **Go** 1.24+, **Rust** 1.94+, **Java** 17+, or **.NET** 8.0+. On an older Python, `pip` installs an outdated SDK release rather than reporting the version conflict, and the example below then fails with an error that does not mention the Python version. See [Prerequisites](../getting-started.md#prerequisites).
+
 <details open>
 <summary><strong>Node.js / TypeScript</strong></summary>