From ecaebe0054d4ee5dc209fc51a00a97293de73df3 Mon Sep 17 00:00:00 2001
From: crazywhalecc <jesse2061@outlook.com>
Date: Mon, 20 Apr 2026 14:19:39 +0800
Subject: [PATCH] Add v2 version warning message

---
 docs/.vitepress/config.ts | 4 ++--
 docs/en/guide/index.md    | 5 +++++
 docs/zh/guide/index.md    | 5 +++++
 3 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts
index 576ccddd..df95955d 100644
--- a/docs/.vitepress/config.ts
+++ b/docs/.vitepress/config.ts
@@ -19,7 +19,7 @@ export default {
             text: 'v3 (alpha)',
             items: [
               { text: 'v3 (alpha)', link: '/en/' },
-              { text: 'v2', link: '/v2/en/guide/' },
+              { text: 'v2', link: 'https://static-php.github.io/v2-docs/' },
             ],
           },
         ],
@@ -43,7 +43,7 @@ export default {
             text: 'v3 (alpha)',
             items: [
               { text: 'v3 (alpha)', link: '/zh/' },
-              { text: 'v2', link: '/v2/zh/guide/' },
+              { text: 'v2', link: 'https://static-php.github.io/v2-docs/' },
             ],
           },
         ],
diff --git a/docs/en/guide/index.md b/docs/en/guide/index.md
index eca186df..1facd732 100644
--- a/docs/en/guide/index.md
+++ b/docs/en/guide/index.md
@@ -1,5 +1,10 @@
 # Guide
 
+::: warning
+You are reading the documentation for StaticPHP v3. The v2 version will be deprecated after the stable release of v3. 
+The 3.0 version is currently in the alpha stage, and you can view the v2 documentation [here](https://static-php.github.io/v2-docs/).
+:::
+
 ## What is StaticPHP?
 
 StaticPHP is a build tool that compiles the PHP interpreter together with any extensions you need into a single self-contained binary. The target system doesn't need PHP or any runtime libraries installed — just copy the binary and run it. Builds target Linux, macOS, and Windows.
diff --git a/docs/zh/guide/index.md b/docs/zh/guide/index.md
index 2ff02fa2..5bc0292f 100644
--- a/docs/zh/guide/index.md
+++ b/docs/zh/guide/index.md
@@ -1,5 +1,10 @@
 # 构建指南
 
+::: warning
+你正在阅读 StaticPHP v3 版本的文档，v2 版本将在 v3 稳定发布后废弃。v3 版本目前仍处于 alpha 阶段，
+你可以在 [这里](https://static-php.github.io/v2-docs/) 查看 v2 文档。
+:::
+
 ## StaticPHP 是什么
 
 StaticPHP 是一个构建工具，能够将 PHP 解释器与你所需的扩展一起编译成一个独立的二进制文件，无需在目标系统上预先安装 PHP 或任何依赖库。