docs: refresh docs and unify internal links (#4817)

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>

Author: zllkjc

.changeset/docs-improve.md

@@ -0,0 +1,13 @@
+---
+'website-new': patch
+'@module-federation/rspress-plugin': patch
+---
+
+docs: improve guides, configuration, and integrations content
+
+- Unify internal links to absolute `/path/to/page.html` form (drop relative paths and `/zh` / `/en` prefixes).
+- Restructure configuration option pages for consistent formatting.
+- Refresh integration guides for Modern.js, Next.js, Angular, Vue, and React.
+- Reorganize runtime API and hooks reference, and rewrite advanced/start/data guides.
+- Sync all updates between EN and ZH locales.
+- Bump `@rspress/shared` runtime dep and `@rspress/core` peer to `2.0.14`.

apps/website-new/docs/en/ai/index.mdx

@@ -6,7 +6,7 @@ sidebar: false
 # AI Quick Start
 
 :::tip Prefer to read the docs yourself?
-If you want to go through Module Federation concepts, configuration, and integration in order, head to the [Getting Started guide](../guide/start/index).
+If you want to go through Module Federation concepts, configuration, and integration in order, head to the [Getting Started guide](/guide/start/index.html).
 :::
 
 ## A Better Way To Start
@@ -48,12 +48,12 @@ The `mf` skill does more than answer questions. It can also help your agent:
 - inspect remote module information
 - read observability reports and debug MF loading failures
 
-👉 [View Agent Skills documentation](./skill)
+👉 [View Agent Skills documentation](/ai/skill.html)
 
 ## Observe and Debug MF Loading
 
 If you want an AI coding agent to debug Module Federation loading with concrete
-runtime facts, enable the [Observability Plugin](../plugin/plugins/observability-plugin)
+runtime facts, enable the [Observability Plugin](/plugin/plugins/observability-plugin.html)
 first.
 
 After a loading failure, the browser console will print a `traceId` and,
@@ -112,6 +112,6 @@ If you want to start using this workflow right away:
 
 1. Install `mf`
 2. Ask the question you care about most
-3. Enable the [Observability Plugin](../plugin/plugins/observability-plugin) when
+3. Enable the [Observability Plugin](/plugin/plugins/observability-plugin.html) when
    you need MF loading observability
-4. Open [Skills documentation](./skill) to see which sub-commands it supports
+4. Open [Skills documentation](/ai/skill.html) to see which sub-commands it supports

apps/website-new/docs/en/ai/skill.mdx

@@ -9,7 +9,7 @@ Module Federation now exposes one unified **`mf` skill**.
 
 You do not need to pick from a long list of separate skills, and you do not need to read the docs first and then translate them back to your agent. The simpler approach is to install this one skill and let the agent decide whether it should read docs, inspect config, or troubleshoot a problem.
 
-If you have not read it yet, start with [AI Quick Start](./index).
+If you have not read it yet, start with [AI Quick Start](/ai/index.html).
 
 ## Installation
 
@@ -106,7 +106,7 @@ At that point, the goal is not for you to manually investigate first. The goal i
 
 ### 4. Let the agent read MF observability
 
-For full loading observability, install the [Observability Plugin](../plugin/plugins/observability-plugin)
+For full loading observability, install the [Observability Plugin](/plugin/plugins/observability-plugin.html)
 in your app. When a browser console error prints a `traceId` and `read:`
 command, pass it to the skill:
 

apps/website-new/docs/en/blog/index.mdx

@@ -6,25 +6,25 @@ sidebar: false
 
 Find the latest posts and release announcements about Module Federation here.
 
-## [Module Federation 2.0 Stable Release](./v2-stable-version)
+## [Module Federation 2.0 Stable Release](/blog/v2-stable-version.html)
 
 > February 10, 2026
 
 Module Federation 2.0 is officially stable, bringing shared dependency tree shaking and a Modern.js v3 plugin to make integration easier.
 
-## [Module Federation on Node.js: From Usable to Ergonomic](./node)
+## [Module Federation on Node.js: From Usable to Ergonomic](/blog/node.html)
 
 > January 23, 2026
 
 Learn how to use Module Federation in Node.js, including runtime-only consumption, Rspack/Webpack integration, and producer-side build configuration.
 
-## [Handling Remote Module Rendering Errors](./error-load-remote)
+## [Handling Remote Module Rendering Errors](/blog/error-load-remote.html)
 
 > September 9, 2025
 
 Fallback strategies for remote module load/render failures: network retries, the errorLoadRemote hook, and React ErrorBoundary.
 
-## [Release Announcement](./announcement)
+## [Release Announcement](/blog/announcement.html)
 
 > April 26, 2024
 

apps/website-new/docs/en/configure/dts.mdx

@@ -18,7 +18,7 @@ interface PluginDtsOptions {
 }
 ```
 
-### generateTypes
+## generateTypes
 
 - Type: `boolean | DtsRemoteOptions`
 - Required: No
@@ -67,52 +67,52 @@ When configuring `generateTypes` to `true`, the following configuration will be
 }
 ```
 
-#### extractRemoteTypes
+### extractRemoteTypes
 
 - Type: `boolean`
 - Required: No
 - Default value: `undefined`
 - Usage scenario: When the content of the producer `exposes` has its own `remotes` module that re-exports itself, then `extractRemoteTypes: true` can ensure that the consumer can normally obtain the module type of the producer `exposes`
-- Example: [Nested type re-export](../guide/basic/type-prompt#Nested type re-export)
+- Example: [Nested type re-export](/guide/basic/type-prompt.html#nested-type-re-export)
 
 Whether to extract the type of `remotes`.
 
-#### extractThirdParty
+### extractThirdParty
 
 - Type: `boolean`
 - Required: No
 - Default value: `undefined`
 - Usage scenario: When the content of the producer `exposes` contains a module containing `antd`, and the consumer does not have `antd` installed, then `extractThirdParty: true` can ensure that the consumer can normally obtain the module of the producer `exposes` type
-- Example: [Third-party package type extraction](../guide/basic/type-prompt#Third-party package type extraction)
+- Example: [Third-party package type extraction](/guide/basic/type-prompt.html#third-party-package-type-extraction)
 
 Whether to extract third-party package types.
 
-#### generateAPITypes
+### generateAPITypes
 
 - Type: `boolean`
 - Required: No
 - Default value: `undefined`
-- Example: [Federation Runtime API type prompt](../guide/basic/type-prompt#federation-runtime-api-type-prompt)
+- Example: [Federation Runtime API type prompt](/guide/basic/type-prompt.html#federation-runtime-api-type-prompt)
 
 Whether to generate the `loadRemote` type in `Federation Runtime`
 
-#### compileInChildProcess
+### compileInChildProcess
 
 - Type: `boolean`
 - Required: No
 - Default value: `undefined`
 
 Whether generate types in child process
 
-#### abortOnError
+### abortOnError
 
 - Type: `boolean`
 - Required: No
 - Default value: `false`
 
 Whether to throw an error when a problem is encountered during type generation
 
-#### afterGenerate
+### afterGenerate
 
 - Type: `(options: DtsGenerateTypesHookOptions) => Promise<void> | void`
 - Required: No
@@ -133,15 +133,15 @@ new ModuleFederationPlugin({
 });
 ```
 
-#### tsConfigPath
+### tsConfigPath
 
 - Type: `string`
 - Required: No
 - Default value: `path.join(process.cwd(),'./tsconfig.json')`
 > priority: dts.generateTypes.tsConfigPath > dts.tsConfigPath
 tsconfig configuration file path
 
-#### outputDir
+### outputDir
 
 - Type: `string`
 - Required: No
@@ -174,39 +174,39 @@ With the config above, the generated files are emitted to
 `dist/react/production/@mf-types.zip` and
 `dist/react/production/@mf-types.d.ts`.
 
-#### typesFolder
+### typesFolder
 
 - Type: `string`
 - Required: No
 - Default value: `'@mf-types'`
 
 The name of the generated compression type file. For example, if typesFolder is set to `custom`, then the name of the generated compression type file is: `custom.zip`
 
-#### deleteTypesFolder
+### deleteTypesFolder
 
 - Type: `boolean`
 - Required: No
   -Default: `true`
 
 Whether to delete the generated type folder
 
-#### compilerInstance
+### compilerInstance
 
 - Type: `'tsc' | 'tsgo' | 'vue-tsc' | 'tspc' | string`
 - Required: No
 - Default value: `'tsc'`
 
 Instance of compiled type
 
-#### deleteTsConfig
+### deleteTsConfig
 
 - Type: `boolean`
 - Required: No
 - Default value: `true`
 
 Whether to delete the temporary tsconfig configuration file.
 
-### consumeTypes
+## consumeTypes
 
 - Type: `boolean | DtsHostOptions`
 - Required: No
@@ -236,56 +236,56 @@ When configuring `consumeTypes` to `true`, the following configuration will be g
 }
 ```
 
-#### consumeAPITypes
+### consumeAPITypes
 
 - Type: `boolean`
 - Required: No
 - Default value: `true`
-- Example: [Federation Runtime API type prompt](../guide/basic/type-prompt#federation-runtime-api-type-prompt)
+- Example: [Federation Runtime API type prompt](/guide/basic/type-prompt.html#federation-runtime-api-type-prompt)
 
 Whether to generate the type of runtime `loadRemote` API
 
-#### maxRetries
+### maxRetries
 
 - Type: `number`
 - Required: No
 - Default value: `3`
 
 Maximum number of retries for failed loading
 
-#### abortOnError
+### abortOnError
 
 - Type: `boolean`
 - Required: No
 - Default value: `false`
 
 Whether to throw an error when a problem is encountered during type loading
 
-#### typesFolder
+### typesFolder
 
 - Type: `string`
 - Required: No
 - Default value: `'@mf-types'`
 
 Type storage directory after successful loading
 
-#### deleteTypesFolder
+### deleteTypesFolder
 
 - Type: `boolean`
 - Required: No
 - Default value: `true`
 
 Before loading type files, whether to delete the previously loaded `typesFolder` directory
 
-#### remoteTypesFolder
+### remoteTypesFolder
 
 - Type: `string`
 - Required: No
 - Default value: `'@mf-types'`
 
 `typesFolder` corresponding to `remotes` directory configuration
 
-#### remoteTypeUrls
+### remoteTypeUrls
 
 - Type: `(() => Promise<RemoteTypeUrls>) | RemoteTypeUrls`
 - Required: No
@@ -354,38 +354,38 @@ export default createModuleFederationConfig({
 });
 ```
 
-#### family
+### family
 
 - Type: `0 | 4 | 6`
 - Required: No
-- Default value: 0
+- Default value: `0`
 
 Configure the IP version family that will be used for network operations.
 
-#### typesOnBuild
+### typesOnBuild
 - Type: `boolean`
 - Required: No
 - Default: `false`
 
 By default, Module Federation does not load type files in production ( process.env.NODE_ENV === 'production' ). To enable type loading in production builds, set typesOnBuild to true .
 
-### tsConfigPath
+## tsConfigPath
 
 - Type: `string`
 - Required: No
 - Default value: `path.join(process.cwd(),'./tsconfig.json')`
 
 tsconfig configuration file path
 
-### cwd
+## cwd
 
 - Type: `string`
 - Required: No
 - Default value: `undefined`
 
 The working directory to run the compiler
 
-### displayErrorInTerminal
+## displayErrorInTerminal
 
 - Type: `boolean`
 - Required: No