docs(builder): optimize the document of tools configurations (#3711)

Author: chenjiahan

packages/document/builder-doc/docs/en/config/output/dataUriLimit.md

@@ -1,4 +1,4 @@
-- **Type**
+- **Type:**
 
 ```ts
 type DataUriLimitConfig = {
@@ -9,7 +9,7 @@ type DataUriLimitConfig = {
 };
 ```
 
-- **Default**
+- **Default:**
 
 ```js
 const defaultDatUriLimit = {

packages/document/builder-doc/docs/en/config/output/distPath.md

@@ -1,4 +1,4 @@
-- **Type**
+- **Type:**
 
 ```ts
 type DistPathConfig = {
@@ -14,7 +14,7 @@ type DistPathConfig = {
 };
 ```
 
-- **Default**
+- **Default:**
 
 ```js
 const defaultDistPath = {

packages/document/builder-doc/docs/en/config/output/filename.md

@@ -1,4 +1,4 @@
-- **Type**
+- **Type:**
 
 ```ts
 type FilenameConfig = {
@@ -11,7 +11,7 @@ type FilenameConfig = {
 };
 ```
 
-- **Default**
+- **Default:**
 
 ```js
 // Development

packages/document/builder-doc/docs/en/config/output/svgDefaultExport.md

@@ -1,5 +1,5 @@
-- **Type:** `url` | `component`
-- **Default:** `url`
+- **Type:** `'url' | 'component'`
+- **Default:** `'url'`
 
 `output.svgDefaultExport` is used to configure the default export type of SVG files.
 

packages/document/builder-doc/docs/en/config/tools/babel.md

@@ -1,10 +1,10 @@
 - **Type:** `Object | Function`
 - **Default:** `undefined`
 
-By `tools.babel` you can modify the options of [babel-loader](https://github.com/babel/babel-loader).
+With `tools.babel` you can modify the options of [babel-loader](https://github.com/babel/babel-loader).
 
 :::warning
-When using Rspack as a packaging tool, using this configuration item will slow down Rspack builds a bit. Because Rspack uses SWC compilation by default, there will be additional compilation overhead when configuring the Babel.
+When using Rspack as the bundler, using this configuration will slow down the build speed of Rspack. As Rspack uses SWC compilation by default, there will be additional compilation overhead when using the Babel.
 :::
 
 ### Function Type

packages/document/builder-doc/docs/en/config/tools/rspack.md

@@ -1,12 +1,14 @@
-- **Type:** `Object` | `Function` | `undefined`
+- **Type:** `Object | Function | undefined`
 - **Default:** `undefined`
 - **Bundler:** `only support Rspack`
 
 `tools.rspack` is used to configure [Rspack](https://www.rspack.dev/).
 
 ### Object Type
 
-You can configure it as an object, which will be merged with the original Rspack configuration through [webpack-merge](https://github.com/survivejs/webpack-merge). For example:
+`tools.rspack` can be configured as an object to be deep merged with the built-in Rspack configuration through [webpack-merge](https://github.com/survivejs/webpack-merge).
+
+For example, add `resolve.alias` configuration:
 
 ```js
 export default {
@@ -24,7 +26,7 @@ export default {
 
 ### Function Type
 
-You can also configure it as a function, which accepts one parameter, the original Rspack configuration, you can modify this configuration, and then return a new configuration. For example:
+`tools.rspack` can be configured as a function. The first parameter of this function is the built-in Rspack configuration object, you can modify this object, and then return it. For example:
 
 ```js
 export default {
@@ -37,7 +39,11 @@ export default {
 };
 ```
 
-The second parameter of this function is an object that contains some information about the tool collection. Details are as follows:
+:::tip
+The object returned by the `tools.rspack` function is used directly as the final Rspack configuration and is not merged with the built-in Rspack configuration.
+:::
+
+The second parameter of this function is an object, which contains some utility functions and properties, as follows:
 
 ### Utils
 
@@ -136,7 +142,7 @@ export default {
 };
 ```
 
-### addRules
+#### addRules
 
 - **Type:** `(rules: RuleSetRule | RuleSetRule[]) => void`
 
@@ -170,7 +176,7 @@ export default {
 };
 ```
 
-### prependPlugins
+#### prependPlugins
 
 - **Type:** `(plugins: RspackPluginInstance | RspackPluginInstance[]) => void`
 
@@ -190,7 +196,7 @@ export default {
 };
 ```
 
-### appendPlugins
+#### appendPlugins
 
 - **Type:** `(plugins: RspackPluginInstance | RspackPluginInstance[]) => void`
 
@@ -210,7 +216,7 @@ export default {
 };
 ```
 
-### removePlugin
+#### removePlugin
 
 - **Type:** `(name: string) => void`
 
@@ -228,7 +234,7 @@ export default {
 };
 ```
 
-### mergeConfig
+#### mergeConfig
 
 - **Type:** `(...configs: RspackConfig[]) => RspackConfig`
 
@@ -246,7 +252,7 @@ export default {
 };
 ```
 
-### getCompiledPath
+#### getCompiledPath
 
 - **Type:** `(name: string) => string`
 

packages/document/builder-doc/docs/en/config/tools/styledComponents.md

@@ -1,5 +1,5 @@
 - **Type:** `Object | Function`
-- **Default**
+- **Default:**
 
 ```js
 {

packages/document/builder-doc/docs/en/config/tools/webpack.md

@@ -1,4 +1,4 @@
-- **Type:** `Object` | `Function` | `undefined`
+- **Type:** `Object | Function | undefined`
 - **Default:** `undefined`
 - **Bundler:** `only support webpack`
 
@@ -8,7 +8,9 @@
 
 ### Object Type
 
-You can configure it as an object, which will be merged with the original webpack configuration through [webpack-merge](https://github.com/survivejs/webpack-merge). For example:
+`tools.webpack` can be configured as an object to be deep merged with the built-in webpack configuration through [webpack-merge](https://github.com/survivejs/webpack-merge).
+
+For example, add `resolve.alias` configuration:
 
 ```js
 export default {
@@ -26,7 +28,7 @@ export default {
 
 ### Function Type
 
-You can also configure it as a function, which accepts one parameter, the original webpack configuration, you can modify this configuration, and then return a new configuration. For example:
+`tools.webpack` can be configured as a function. The first parameter of this function is the built-in webpack configuration object, you can modify this object, and then return it. For example:
 
 ```js
 export default {
@@ -39,10 +41,14 @@ export default {
 };
 ```
 
-The second parameter of this function is an object that contains some information about the tool collection. Details are as follows:
+:::tip
+The object returned by the `tools.webpack` function is used directly as the final webpack configuration and is not merged with the built-in webpack configuration.
+:::
 
 ### Utils
 
+The second parameter of this function is an object, which contains some utility functions and properties, as follows:
+
 #### env
 
 - **Type:** `'development' | 'production' | 'test'`
@@ -155,7 +161,7 @@ export default {
 };
 ```
 
-### HtmlWebpackPlugin
+#### HtmlWebpackPlugin
 
 - **Type:** `typeof import('html-webpack-plugin')`
 
@@ -171,7 +177,7 @@ export default {
 };
 ```
 
-### addRules
+#### addRules
 
 - **Type:** `(rules: RuleSetRule | RuleSetRule[]) => void`
 
@@ -205,7 +211,7 @@ export default {
 };
 ```
 
-### prependPlugins
+#### prependPlugins
 
 - **Type:** `(plugins: WebpackPluginInstance | WebpackPluginInstance[]) => void`
 
@@ -229,7 +235,7 @@ export default {
 };
 ```
 
-### appendPlugins
+#### appendPlugins
 
 - **Type:** `(plugins: WebpackPluginInstance | WebpackPluginInstance[]) => void`
 
@@ -253,7 +259,7 @@ export default {
 };
 ```
 
-### removePlugin
+#### removePlugin
 
 - **Type:** `(name: string) => void`
 
@@ -271,7 +277,7 @@ export default {
 };
 ```
 
-### mergeConfig
+#### mergeConfig
 
 - **Type:** `(...configs: WebpackConfig[]) => WebpackConfig`
 
@@ -289,7 +295,7 @@ export default {
 };
 ```
 
-### getCompiledPath
+#### getCompiledPath
 
 - **Type:** `(name: string) => string`
 

packages/document/builder-doc/docs/zh/config/output/dataUriLimit.md

@@ -1,4 +1,4 @@
-- **类型**
+- **类型：**
 
 ```ts
 type DataUriLimitConfig = {
@@ -9,7 +9,7 @@ type DataUriLimitConfig = {
 };
 ```
 
-- **默认值**
+- **默认值：**
 
 ```js
 const defaultDatUriLimit = {

packages/document/builder-doc/docs/zh/config/output/distPath.md

@@ -1,4 +1,4 @@
-- **类型**
+- **类型：**
 
 ```ts
 type DistPathConfig = {
@@ -14,7 +14,7 @@ type DistPathConfig = {
 };
 ```
 
-- **默认值**
+- **默认值：**
 
 ```js
 const defaultDistPath = {