docs(config): improve node options docs (#12236)

* docs(config): improve `node.global` docs

* docs: update

* docs

Author: chenjiahan

website/docs/en/config/mode.mdx

@@ -1,7 +1,7 @@
 import WebpackLicense from '@components/WebpackLicense';
 import PropertyType from '@components/PropertyType';
 
-<WebpackLicense from="https://webpack.js.org/configuration/node/" />
+<WebpackLicense from="https://webpack.js.org/configuration/mode/" />
 
 # Mode
 

website/docs/en/config/node.mdx

@@ -8,23 +8,37 @@ The following Node.js options configure whether to polyfill or mock certain [Nod
 
 ## node.global
 
-- **Type:** `boolean` `'warn'`
+- **Type:** `boolean | 'warn'`
 - **Default:** `'warn'`
 
+Controls whether Rspack should provide a polyfill for the Node.js `global` object when bundling for non-Node environments.
+
 See [the Node.js documentation](https://nodejs.org/api/globals.html#globals_global) for the exact behavior of this object.
 
-Options:
+Optional values:
+
+- `true`: Rspack injects a polyfill so that `global` is available in the bundle. This ensures compatibility with code that relies on Node.js globals in non-Node runtimes.
+- `false`: No polyfill is provided. References to `global` remain untouched. If your target environment does not define `global`, accessing it will throw a `ReferenceError` at runtime.
+- `'warn'`: Inject a polyfill like `true`, but also emit a warning when `global` is used.
+
+For example, to disable `global` polyfill:
 
-- `true`: Provide a polyfill.
-- `false`: Provide nothing. Code that expects this object may crash with a `ReferenceError`.
-- `'warn'`: Show a warning when using `global`.
+```js title="rspack.config.mjs"
+export default {
+  node: {
+    global: false,
+  },
+};
+```
 
 ## node.\_\_filename
 
-- **Type:** `boolean` `'mock' | 'warn-mock' | 'eval-only'`
-- **Default:** `'warn-mock'`, `'node-module'` when `output.module` is enabled
+- **Type:** `boolean | 'mock' | 'warn-mock' | 'eval-only'`
+- **Default:** `'warn-mock'`, `'node-module'` when [output.module](/config/output#outputmodule) is enabled
+
+Controls how Rspack handles the Node.js [`__filename`](https://nodejs.org/api/modules.html#__filename) variable when bundling for non-Node environments.
 
-Options:
+Optional values:
 
 - `true`: The filename of the input file relative to the [`context`](/config/context) option.
 - `false`: Rspack won't touch your `__filename` code, which means you have the regular Node.js `__filename` behavior. The filename of the **output** file when run in a Node.js environment.
@@ -33,16 +47,38 @@ Options:
 - `'node-module'`: Replace `__filename` in CommonJS modules to `fileURLToPath(import.meta.url)` when `output.module` is enabled.
 - `'eval-only'`: Equivalent to `false`.
 
+For example, to leave `__filename` as it is:
+
+```js title="rspack.config.mjs"
+export default {
+  node: {
+    __filename: false,
+  },
+};
+```
+
 ## node.\_\_dirname
 
-- **Type:** `boolean` `'mock' | 'warn-mock' | 'eval-only'`
+- **Type:** `boolean | 'mock' | 'warn-mock' | 'eval-only'`
 - **Default:** `'warn-mock'`, `'node-module'` when `output.module` is enabled
 
-Options:
+Controls how Rspack handles the Node.js [`__dirname`](https://nodejs.org/api/modules.html#__dirname) variable when bundling for non-Node environments.
+
+Optional values:
 
 - `true`: The dirname of the **input** file relative to the [`context`](/config/context) option.
 - `false`: Rspack won't touch your `__dirname` code, which means you have the regular Node.js `__dirname` behavior. The dirname of the **output** file when run in a Node.js environment.
 - `'mock'`: The fixed value `'/'`.
 - `'warn-mock'`: Use the fixed value of `'/'` but show a warning.
 - `'node-module'`: Replace `__dirname` in CommonJS modules to `fileURLToPath(import.meta.url + "/..")` when `output.module` is enabled.
 - `'eval-only'`: Equivalent to `false`.
+
+For example, to leave `__dirname` as it is:
+
+```js title="rspack.config.mjs"
+export default {
+  node: {
+    __dirname: false,
+  },
+};
+```

website/docs/zh/config/mode.mdx

@@ -1,7 +1,7 @@
 import WebpackLicense from '@components/WebpackLicense';
 import PropertyType from '@components/PropertyType';
 
-<WebpackLicense from="https://webpack.js.org/configuration/node/" />
+<WebpackLicense from="https://webpack.js.org/configuration/mode/" />
 
 # Mode
 

website/docs/zh/config/node.mdx

@@ -11,18 +11,34 @@ import WebpackLicense from '@components/WebpackLicense';
 - **类型：** `boolean | 'warn'`
 - **默认值：** `'warn'`
 
-选项：
+控制 Rspack 在为非 Node 环境打包时，是否需要为 Node.js 的 `global` 对象提供 polyfill。
 
-- `true`：提供 polyfill.
-- `false`：不提供任何 polyfill。代码可能会出现 `ReferenceError` 的崩溃。
-- `'warn'`：当使用 `global` 时展示一个警告。
+关于该对象的具体行为，请参考 [Node.js 文档](https://nodejs.org/api/globals.html#globals_global)。
+
+可选值有：
+
+- `true`：Rspack 会注入 polyfill，使打包产物中能够使用 `global`。适用于依赖 Node.js 全局变量、但运行在非 Node 环境的代码。
+- `false`：不注入 polyfill。对 `global` 的引用将保持原样。如果目标环境不支持 `global`，运行时会抛出 `ReferenceError`。
+- `'warn'`：行为与 `true` 相同，会注入 polyfill，同时在使用 `global` 时额外打印警告。
+
+例如，禁用 `global` polyfill：
+
+```js title="rspack.config.mjs"
+export default {
+  node: {
+    global: false,
+  },
+};
+```
 
 ## node.\_\_filename
 
 - **类型：** `boolean | 'mock' | 'warn-mock' | 'eval-only'`
-- **默认值：** `'warn-mock'`，当启用 `output.module` 时为 `'node-module'`
+- **默认值：** `'warn-mock'`，当启用 [output.module](/config/output#outputmodule) 时为 `'node-module'`
+
+控制 Rspack 在为非 Node 环境打包时，如何处理 Node.js 的 [`__filename`](https://nodejs.org/api/modules.html#__filename) 变量。
 
-选项：
+可选值有：
 
 - `true`：输入文件的文件名，是相对于 [`context`](/config/context) 选项。
 - `false`：Rspack 不会更改 `__filename` 的代码。在 Node.js 环境中运行时输出文件的文件名。
@@ -31,16 +47,38 @@ import WebpackLicense from '@components/WebpackLicense';
 - `'node-module'`：当 `output.module` 启用时，将 CommonJS 模块中的 `__filename` 替换为 `fileURLToPath(import.meta.url)`。
 - `'eval-only'`：等同于 `false`。
 
+例如，不对 `__filename` 进行任何处理：
+
+```js title="rspack.config.mjs"
+export default {
+  node: {
+    __filename: false,
+  },
+};
+```
+
 ## node.\_\_dirname
 
 - **类型：** `boolean | 'mock' | 'warn-mock' | 'eval-only'`
-- **默认值：** `'warn-mock'`，当启用 `output.module` 时为 `'node-module'`
+- **默认值：** `'warn-mock'`，当启用 [output.module](/config/output#outputmodule) 时为 `'node-module'`
+
+控制 Rspack 在为非 Node 环境打包时，如何处理 Node.js 的 [`__dirname`](https://nodejs.org/api/modules.html#__dirname) 变量。
 
-选项：
+可选值有：
 
 - `true`：**输入** 文件的目录名，是相对于 [`context`](/config/context) 选项。
-- `false`：webpack 不会更改 `__dirname` 的代码，这意味着你有常规 Node.js 中的 `__dirname` 的行为。在 Node.js 环境中运行时，**输出** 文件的目录名。
+- `false`：Rspack 不会更改 `__dirname` 的代码，这意味着你有常规 Node.js 中的 `__dirname` 的行为。在 Node.js 环境中运行时，**输出** 文件的目录名。
 - `'mock'`：value 填充为 `'/'`。
 - `'warn-mock'`：使用 `'/'` 但是会显示一个警告。
 - `'node-module'`: 当启用 `output.module` 时，将 CommonJS 模块中的 `__dirname` 替换为 `fileURLToPath(import.meta.url + "/..")`。
 - `'eval-only'`：等同于 `false`。
+
+例如，不对 `__dirname` 进行任何处理：
+
+```js title="rspack.config.mjs"
+export default {
+  node: {
+    __dirname: false,
+  },
+};
+```