diff --git a/website/docs/en/guide/faq/features.mdx b/website/docs/en/guide/faq/features.mdx
index 4066364c4..20292a44f 100644
--- a/website/docs/en/guide/faq/features.mdx
+++ b/website/docs/en/guide/faq/features.mdx
@@ -181,6 +181,16 @@ export default {
 };
 ```
 
+## Rsbuild plugin
+
+### Why does using `modifyRsbuildConfig` to modify the configuration does not take effect?
+
+Rslib internally generates Rsbuild's environments configurations, and each configuration item in the [lib](/config/lib/index) array corresponds to a specific environment configuration.
+
+[modifyRsbuildConfig](https://rsbuild.rs/plugins/dev/hooks#modifyrsbuildconfig) is a global hook that cannot be effective for configurations under a specific environment. It is usually used in Rslib to modify globally effective plugins, etc. Therefore, you need to use [modifyEnvironmentConfig](https://rsbuild.rs/plugins/dev/hooks#modifyenvironmentconfig) instead to modify the configuration of a specific environment.
+
+Refer to [Environment Plugin](https://rsbuild.rs/plugins/dev/#environment-plugin) to learn how to develop an Environment Plugin.
+
 ## Miscellaneous
 
 ### How to preserve module variables such as `__webpack_hash__` in the source code when generating outputs?
diff --git a/website/docs/zh/guide/faq/features.mdx b/website/docs/zh/guide/faq/features.mdx
index 38227dbab..088879d79 100644
--- a/website/docs/zh/guide/faq/features.mdx
+++ b/website/docs/zh/guide/faq/features.mdx
@@ -181,6 +181,16 @@ export default {
 };
 ```
 
+## Rsbuild 插件
+
+### 为什么使用 `modifyRsbuildConfig` 修改配置不生效？
+
+Rslib 会在内部生成 Rsbuild 的 environments 配置，每一个 [lib](/config/lib/index) 数组中的配置项对应一个特定 environment 配置。
+
+[modifyRsbuildConfig](https://rsbuild.rs/zh/plugins/dev/hooks#modifyrsbuildconfig) 是一个全局 hook，无法对特定 environment 下的配置生效，在 Rslib 中通常用于修改全局生效的 plugins 等。因此需要使用 [modifyEnvironmentConfig](https://rsbuild.rs/zh/plugins/dev/hooks#modifyenvironmentconfig) 代替来修改特定 environment 的配置。
+
+参考 [Environment 插件](https://rsbuild.rs/zh/plugins/dev/#environment-插件) 了解如何开发一个 Environment 插件。
+
 ## 其他
 
 ### 如何在生成产物时保留源码中的 `__webpack_hash__` 等模块变量？