fix doc claim

Author: haochengxia

docs/src/en/developer.md

@@ -45,10 +45,15 @@ pip install -e ".[dev]"
 
 The `dev` extra brings in `pytest`, `ruff`, `mypy`, and `pre-commit`.
 
-`scripts/install.sh` does all of the above and then runs the tests. Pass `--all` to enable the
-optional learned algorithms:
+`scripts/install.sh` automates most of this: it updates the submodule, installs the package
+editable, verifies the import, and runs the tests. Note that it installs plain `-e .` plus
+`pytest`, **not** the full `dev` extra — so `ruff`, `mypy` and `pre-commit` still need the
+command above if you want them. Pass `--all` to enable the optional learned algorithms:
 
 ```bash
+# --all only flips the CMake options on; install LightGBM/XGBoost first or
+# configuration fails with LIGHTGBM_PATH not found
+bash scripts/install_deps.sh        # or install_deps_user.sh without sudo
 bash scripts/install.sh --all
 ```
 

docs/src/en/getting_started/installation.md

@@ -102,7 +102,7 @@ pip install .
 ```
 
 `scripts/install.sh` wraps the whole flow — it updates the submodule, installs the package in
-editable mode, checks that the import works, and runs the test suite:
+editable mode (`pip install -e .`), checks that the import works, and runs the test suite:
 
 ```bash
 bash scripts/install.sh
@@ -111,6 +111,16 @@ bash scripts/install.sh
 bash scripts/install.sh --all
 ```
 
+!!! warning "`--all` needs the learned-algorithm dependencies first"
+    `--all` only turns the three CMake options on; it does **not** install LightGBM and XGBoost.
+    On a machine that does not already have them, the build then fails during configuration with
+    an error such as `LIGHTGBM_PATH not found`. Run the dependency script first:
+
+    ```bash
+    bash scripts/install_deps.sh        # or install_deps_user.sh without sudo
+    bash scripts/install.sh --all
+    ```
+
 Building the extension requires a C++17 compiler, CMake ≥ 3.15, and Ninja, plus three native
 dependencies that CMake looks for at configure time: **pkg-config**, **GLib 2.0** and
 **Zstandard**. All three are mandatory — `CMakeLists.txt` declares them with

docs/src/zh/developer.md

@@ -43,9 +43,12 @@ pip install -e ".[dev]"
 
 `dev` 附加依赖会引入 `pytest`、`ruff`、`mypy` 和 `pre-commit`。
 
-`scripts/install.sh` 会完成上述全部步骤并随后运行测试。加上 `--all` 可启用可选的学习型算法：
+`scripts/install.sh` 自动化了其中大部分工作：更新子模块、以可编辑模式安装、验证导入，并运行测试。注意它安装的是普通的 `-e .` 外加 `pytest`，**并非**完整的 `dev` 附加依赖——如果需要 `ruff`、`mypy` 和 `pre-commit`，仍要执行上面的命令。加上 `--all` 可启用可选的学习型算法：
 
 ```bash
+# --all 只是打开 CMake 选项；请先安装 LightGBM/XGBoost，
+# 否则配置阶段会因 LIGHTGBM_PATH not found 而失败
+bash scripts/install_deps.sh        # 无 sudo 权限时用 install_deps_user.sh
 bash scripts/install.sh --all
 ```
 

docs/src/zh/getting_started/installation.md

@@ -88,7 +88,7 @@ git submodule update --init --recursive
 pip install .
 ```
 
-`scripts/install.sh` 封装了整个流程——它会更新子模块、以可编辑模式安装本包、检查导入是否正常，并运行测试套件：
+`scripts/install.sh` 封装了整个流程——它会更新子模块、以可编辑模式安装本包（`pip install -e .`）、检查导入是否正常，并运行测试套件：
 
 ```bash
 bash scripts/install.sh
@@ -97,6 +97,14 @@ bash scripts/install.sh
 bash scripts/install.sh --all
 ```
 
+!!! warning "`--all` 需要先安装学习型算法的依赖"
+    `--all` 只是打开三个 CMake 选项，并**不会**安装 LightGBM 和 XGBoost。在尚未装好它们的机器上，构建会在配置阶段失败，报出类似 `LIGHTGBM_PATH not found` 的错误。请先运行依赖脚本：
+
+    ```bash
+    bash scripts/install_deps.sh        # 无 sudo 权限时用 install_deps_user.sh
+    bash scripts/install.sh --all
+    ```
+
 构建扩展需要支持 C++17 的编译器、CMake ≥ 3.15 以及 Ninja，另外还需要三个在 configure 阶段查找的原生依赖：**pkg-config**、**GLib 2.0** 和 **Zstandard**。这三者都是必需的——`CMakeLists.txt` 中分别以 `find_package(PkgConfig REQUIRED)`、`pkg_check_modules(GLib REQUIRED glib-2.0)` 和 `find_package(ZSTD REQUIRED)` 声明——缺少任意一个都会在编译任何代码之前中断配置，并报出类似 `No package 'glib-2.0' found` 的错误。
 
 上文的依赖脚本会在其支持的平台上安装它们（`install_deps.sh` 面向基于 yum 的发行版和 macOS）。在 Debian/Ubuntu 上，请使用子模块提供的脚本，或直接安装：