docs: optimize doc

Author: 2heal1

website/docs/en/plugins/webpack/tree-shake-shared-plugin.mdx

@@ -5,42 +5,41 @@ import { Stability, ApiMeta } from '@components/ApiMeta';
 <ApiMeta stability={Stability.Experimental} />
 
 **Overview**
-- Performs on-demand builds and export optimization for `shared` dependencies in Module Federation.
-- When `reshake` is false, enables `SharedUsedExportsOptimizerPlugin` to inject runtime used-exports.
-- If any shared entry has `treeshake: true` and `import !== false`, uses `IndependentSharedPlugin` to build independent artifacts per shared package and write back to stats/manifest.
+
+- Performs on-demand build and export optimization for `shared` dependencies based on Module Federation configuration.
 
 **Options**
-- `mfConfig`: `ModuleFederationPluginOptions` with `name`, `shared`, `library`, `manifest`, `injectUsedExports`.
-- `plugins`: extra plugins reused in independent builds.
-- `reshake`: whether to perform additional tree-shaking during independent builds.
+
+- `mfConfig`: `ModuleFederationPluginOptions`, configuration passed to the Module Federation plugin.
+- `plugins`: extra plugins reused during independent builds.
+- `reshake`: whether to perform a second tree-shake during independent builds (typically used when the deployment platform has determined complete dependency info and triggers a fresh build to improve tree-shake accuracy for shared dependencies).
 
 **Usage**
+
 ```js
 // rspack.config.js
 const { TreeShakeSharedPlugin } = require('@rspack/core');
 
 module.exports = {
   plugins: [
     new TreeShakeSharedPlugin({
+      reshake: true,
       mfConfig: {
         name: 'app',
         shared: {
           'lodash-es': { treeshake: true },
-          react: { treeshake: true, requiredVersion: '18.3.1' }
         },
         library: { type: 'var', name: 'App' },
-        manifest: { statsFileName: 'stats.json', manifestFileName: 'manifest.json' },
-        injectUsedExports: true
+        manifest: true,
       },
       plugins: [],
-      reshake: false
-    })
-  ]
+    }),
+  ],
 };
 ```
 
 **Behavior**
-- Normalizes `shared` into `[shareName, SharedConfig][]`.
-- Registers `SharedUsedExportsOptimizerPlugin` when `reshake` is `false` to inject used exports from stats.
-- Triggers independent compilation for `treeshake` entries and writes produced assets back into stats/manifest.
 
+- Normalizes `shared` into `[shareName, SharedConfig][]`.
+- Registers `SharedUsedExportsOptimizerPlugin` when `reshake` is `false` to inject used-exports from the stats manifest.
+- Triggers independent compilation for shared entries with `treeshake: true`, and writes the produced assets back to the `stats/manifest` (fallback fields).

website/docs/zh/plugins/webpack/tree-shake-shared-plugin.mdx

@@ -5,42 +5,41 @@ import { Stability, ApiMeta } from '@components/ApiMeta';
 <ApiMeta stability={Stability.Experimental} />
 
 **概览**
-- 基于模块联邦配置对 shared 依赖进行按需构建与导出优化。
-- 非 `reshake` 模式下，启用 `SharedUsedExportsOptimizerPlugin` 注入运行时已用导出信息。
-- 当 shared 项存在 `treeshake: true` 且 `import !== false` 时，使用 `IndependentSharedPlugin` 为每个共享包生成独立产物并回填到清单。
+
+基于模块联邦配置对 shared 依赖进行按需构建与导出优化。
 
 **选项**
-- `mfConfig`：`ModuleFederationPluginOptions`，传入模块联邦的 name、shared、library、manifest、injectUsedExports。
+
+- `mfConfig`：`ModuleFederationPluginOptions`，传入模块联邦插件所需要的配置项。
 - `plugins`：额外插件列表，可在独立编译中复用。
-- `reshake`：是否在独立编译阶段执行二次摇树优化。
+- `reshake`：是否在独立编译阶段执行二次摇树优化（二次摇树通常在部署平台确定了完整的依赖信息后重新触发的一次全新构建，提高共享依赖 treeshake 命中的准确率）。
 
 **使用示例**
+
 ```js
 // rspack.config.js
 const { TreeShakeSharedPlugin } = require('@rspack/core');
 
 module.exports = {
   plugins: [
     new TreeShakeSharedPlugin({
+      reshake: true,
       mfConfig: {
         name: 'app',
         shared: {
           'lodash-es': { treeshake: true },
-          react: { treeshake: true, requiredVersion: '18.3.1' }
         },
         library: { type: 'var', name: 'App' },
-        manifest: { statsFileName: 'stats.json', manifestFileName: 'manifest.json' },
-        injectUsedExports: true
+        manifest: true,
       },
       plugins: [],
-      reshake: false
-    })
-  ]
+    }),
+  ],
 };
 ```
 
 **行为说明**
+
 - 读取 `shared` 配置后标准化为 `[shareName, SharedConfig][]`。
 - 当 `reshake` 为 `false` 时，注册 `SharedUsedExportsOptimizerPlugin`，基于 stats 清单注入已用导出集合。
 - 对 `treeshake` 的共享包触发独立编译，产出回写到 stats/manifest 中的 fallback 字段。
-