chore: update

Author: Timeless0911

packages/plugin-dts/README.md

@@ -4,7 +4,7 @@
 
 # rsbuild-plugin-dts
 
-An Rsbuild plugin to emit declaration files for TypeScript which is built-in in Rslib.
+An [Rsbuild plugin](https://www.npmjs.com/package/rsbuild-plugin-dts) to emit declaration files for TypeScript which is built-in in Rslib.
 
 ## Using in Rslib
 
@@ -18,7 +18,7 @@ Install:
 npm add rsbuild-plugin-dts -D
 ```
 
-Add plugin to your `rsbuild.config.ts`:
+Add plugin to `rsbuild.config.ts`:
 
 ```ts
 // rsbuild.config.ts
@@ -38,15 +38,15 @@ export default {
 
 Whether to bundle the DTS files.
 
-If you want to generate [bundle DTS](https://lib.rsbuild.dev/guide/advanced/dts#bundle-dts) files, you should:
+If you want to [bundle DTS](https://lib.rsbuild.dev/guide/advanced/dts#bundle-dts) files, you should:
 
-- Install `@microsoft/api-extractor` as a development dependency.
+1. Install `@microsoft/api-extractor` as a development dependency, which is the underlying tool used for bundling DTS files.
 
 ```bash
 npm add @microsoft/api-extractor -D
 ```
 
-- Set `bundle` to `true`.
+2. Set `bundle` to `true`.
 
 ```js
 pluginDts({
@@ -75,7 +75,7 @@ pluginDts({
 - **Type:** `boolean`
 - **Default:** `false`
 
-Determines whether to generate DTS files while building the project's references. This is equivalent to using the `--build` flag with the `tsc` command.
+Determines whether to generate DTS files while building the project references. This is equivalent to using the `--build` flag with the `tsc` command. See [Project References](https://www.typescriptlang.org/docs/handbook/project-references.html) for more details.
 
 When this option is enabled, you must explicitly set `declarationDir` or `outDir` in `tsconfig.json` in order to meet the build requirements.
 
@@ -86,7 +86,9 @@ When this option is enabled, you must explicitly set `declarationDir` or `outDir
 
 Whether to abort the build process when an error occurs during DTS generation.
 
-By default, type errors will cause the build to fail. When `abortOnError` is set to `false`, the build will still succeed even if there are type issues in the code.
+By default, type errors will cause the build to fail.
+
+When `abortOnError` is set to `false`, the build will still succeed even if there are type issues in the code.
 
 ```js
 pluginDts({
@@ -153,14 +155,14 @@ pluginDts({
 - **Type:** `string`
 - **Default:** `undefined`
 
+Inject content into the bottom of each DTS file.
+
 ```js
 pluginDts({
   footer: '/** @footer */',
 });
 ```
 
-Inject content into the bottom of each DTS file.
-
 ## Contributing
 
 Please read the [Contributing Guide](https://github.com/web-infra-dev/rslib/blob/main/CONTRIBUTING.md).

website/docs/en/config/lib/dts.mdx

@@ -63,15 +63,15 @@ Whether to bundle the DTS files.
 
 #### Example
 
-If you want to generate [bundle DTS](/guide/advanced/dts#bundle-dts) files, you should:
+If you want to [bundle DTS](/guide/advanced/dts#bundle-dts) files, you should:
 
-- Install `@microsoft/api-extractor` as a development dependency.
+1. Install `@microsoft/api-extractor` as a development dependency, which is the underlying tool used for bundling DTS files.
 
 import { PackageManagerTabs } from '@theme';
 
 <PackageManagerTabs command="add @microsoft/api-extractor -D" />
 
-- Set `dts.bundle` to `true`.
+2. Set `dts.bundle` to `true`.
 
 ```ts title="rslib.config.ts" {5-7}
 export default {
@@ -92,6 +92,10 @@ export default {
 
 :::
 
+#### Handle Third-Party Packages
+
+When we bundle DTS files, we should specify which third-party package types need to be bundled, refer to the [Handle Third-Party Dependencies](/guide/advanced/third-party-deps) documentation for more details about externals related configurations.
+
 ### dts.distPath
 
 - **Type:** `string`
@@ -126,7 +130,7 @@ export default {
 - **Type:** `boolean`
 - **Default:** `false`
 
-Determines whether to generate DTS files while building the project's references. This is equivalent to using the `--build` flag with the `tsc` command.
+Determines whether to generate DTS files while building the project references. This is equivalent to using the `--build` flag with the `tsc` command. See [Project References](https://www.typescriptlang.org/docs/handbook/project-references.html) for more details.
 
 ::: note
 
@@ -141,7 +145,9 @@ When this option is enabled, you must explicitly set `declarationDir` or `outDir
 
 Whether to abort the build process when an error occurs during DTS generation.
 
-By default, type errors will cause the build to fail. When `abortOnError` is set to `false`, the build will still succeed even if there are type issues in the code.
+By default, type errors will cause the build to fail.
+
+When `abortOnError` is set to `false` like below, the build will still succeed even if there are type issues in the code.
 
 ```ts title="rslib.config.ts" {5-7}
 export default {

website/docs/en/guide/advanced/dts.mdx

@@ -50,14 +50,16 @@ If you want to generate bundleless DTS, you can:
 
 If you want to generate bundle DTS, you can:
 
-- Install `@microsoft/api-extractor` as a development dependency.
+1. Install `@microsoft/api-extractor` as a development dependency, which is the underlying tool used for bundling DTS files.
 
 import { PackageManagerTabs } from '@theme';
 
 <PackageManagerTabs command="add @microsoft/api-extractor -D" />
 
-- Set `dts: { bundle: true }` in the Rslib configuration file.
+2. Set `dts: { bundle: true }` in the Rslib configuration file.
+
+::: tip
 
 You can refer to [lib.dts](/config/lib/dts) for more details about DTS configuration.
 
-- Specify which third-party package types need to be bundled, refer to the [Handle Third-Party Dependencies](/guide/advanced/third-party-deps) documentation for more details about externals related configurations.
+:::