@modern-js/main-doc 0.0.0-next-20221123182933 → 0.0.0-next-20221124071519

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # @modern-js/main-doc
 
-## 0.0.0-next-20221123182933
+## 0.0.0-next-20221124071519
 
 ### Patch Changes
 
@@ -11,6 +11,7 @@
 - Updated dependencies [2bc090c0]
 - Updated dependencies [f96a7252]
 - Updated dependencies [57077b2c]
+- Updated dependencies [2ff6167b]
 - Updated dependencies [5402fdb0]
 - Updated dependencies [10d08a48]
 - Updated dependencies [5d67c26c]
@@ -19,4 +20,4 @@
 - Updated dependencies [3fae2d03]
 - Updated dependencies [df41d71a]
 - Updated dependencies [14b712da]
-  - @modern-js/builder-doc@0.0.0-next-20221123182933
+  - @modern-js/builder-doc@0.0.0-next-20221124071519

package/en/docusaurus-plugin-content-docs/current/apis/app/commands/_category_.json

@@ -1,5 +1,5 @@
 {
-  "label": "命令",
+  "label": "Commands",
   "position": 3,
   "link": {
     "type": "doc",

package/en/docusaurus-plugin-content-docs/current/apis/app/commands/build.md

@@ -8,18 +8,18 @@ Usage: modern build [options]
 build application
 
 Options:
-  -c --config <config>  指定配置文件路径，可以为相对路径或绝对路径
-  -h, --help  显示命令帮助
-  --analyze   分析构建产物体积，查看各个模块打包后的大小
+  -c --config <config>  configuration file path, which can be a relative path or an absolute path
+  -h, --help            show command help
+  --analyze             analyze the bundle and view size of each module
 ```
 
-`modern build` 命令默认会在 `/dist` 目录下构建出可用于生产环境的产物。
+`modern build` command will by default build production in `dist/`.
 
-可以通过修改配置 [`output.distPath`](/docs/configure/app/output/dist-path) 指定产物的输出目录。
+you can configure the [`output.distPath`](/docs/configure/app/output/dist-path) specifies the output directory for the product.
 
-## 分析构建产物体积
+## Analyze Bundle
 
-执行 `npx modern build --analyze` 命令，可以在打包生产环境代码的同时，产出一个分析构建产物体积的 HTML 文件：
+execute `npx modern build --analyze` command，can produce an HTML file that analyzes the volume of the bundle while packaging the production code:
 
 ```
 Bundle Analyzer saved report to /example/dist/report.html
@@ -31,13 +31,13 @@ File sizes after production build:
   645 B      dist/static/css/main.0dd3ecc1.css
 ```
 
-手动在浏览器中打开上述 HTML 文件，可以看到打包产物的瓦片图，并进行包体积分析和优化：
+Open the above HTML file in the browser, you can see the tile diagram of the packaged product, and perform package volume analysis and optimization:
 
 <img src="https://lf3-static.bytednsdoc.com/obj/eden-cn/aphqeh7uhohpquloj/modern-js/mwa-build-analyze-8784f762c1ab0cb20935829d5f912c4c.png" />
 
-> 该功能基于 [webpack-bundle-analyzer](https://github.com/webpack-contrib/webpack-bundle-analyzer) 实现。
+> this features based on [webpack-bundle-analyzer](https://github.com/webpack-contrib/webpack-bundle-analyzer).
 
-## 命令行参数
+## Command Arguments
 
 import CommandTip from '@site-docs/components/command-tip.md'
 

package/en/docusaurus-plugin-content-docs/current/apis/app/commands/dev.md

@@ -7,17 +7,17 @@ sidebar_position: 1
 ```bash
 Usage: modern dev [options]
 
-本地开发命令
+Development commands
 
 Options:
-  -e --entry <entry>    指定入口，编译特定的页面
-  -c --config <config>  指定配置文件路径，可以为相对路径或绝对路径
-  -h, --help            显示命令帮助
-  --analyze             分析构建产物体积，查看各个模块打包后的大小
-  --api-only            仅启动 API 接口服务
+  -e --entry <entry>    compiler by entry
+  -c --config <config>  configuration file path, which can be a relative path or an absolute path
+  -h, --help            show command help
+  --analyze             analyze the bundle and view size of each module
+  --api-only            only start API service
 ```
 
-`modern dev` 命令启动一个开发服务器，同时监听源文件变化，默认支持 React Fast Refresh：
+`modern dev` start a development server，watch file change，default support React Fast Refresh:
 
 ```bash
 App running at:

package/en/docusaurus-plugin-content-docs/current/apis/app/commands/index.md

@@ -2,9 +2,9 @@
 type: ref
 ---
 
-# 命令
+# Commands
 
-本节涵盖了使用应用工程的所有命令。
+This section covers all commands.
 
 
 

package/en/docusaurus-plugin-content-docs/current/apis/app/commands/inspect.md

@@ -8,32 +8,32 @@ Usage: modern inspect [options]
 inspect internal webpack config
 
 Options:
-  --env <env>           查看指定环境下的配置 (default: "development")
-  --output <output>     指定在 dist 目录下输出的路径 (default: "/")
-  --no-console          不在终端中输出完整结果
-  --verbose             在结果中展示函数的完整内容
-  -c --config <config>  指定配置文件路径，可以为相对路径或绝对路径
-  -h, --help            显示命令帮助
+  --env <env>           view the configuration in the target environment (default: "development")
+  --output <output>     Specify the path to output in the dist (default: "/")
+  --no-console          Do not output the full result in shell
+  --verbose             Show the full function in the result
+  -c --config <config>  configuration file path, which can be a relative path or an absolute path
+  -h, --help            show command help
 ```
 
-`modern inspect` 命令，用于查看项目的 webpack 完整配置。
+`modern inspect` command used to view the full webpack configuration of the project.
 
-在项目根目录下执行命令 `npx modern inspect`，会将 webpack 配置输出在终端界面，同时也会在项目的 `dist` 目录生成一份 `webpack.client.inspect.js` 文件，开发者可手动打开查看。
+Executing the command `npx modern inspect` in the project will output the webpack configuration on the shell, and will also generate a `webpack.client.inspect.js` file in the project's `dist` directory, which developers can open and view manually.
 
-## 指定环境
+## Configuration Env
 
-默认情况下，会输出开发环境的 webpack 配置，可以使用 `env` 选项来输出生产环境的配置：
+By default, the webpack configuration of the development environment is output. And the `env` option can be used to output the configuration of the production environment:
 
 ```bash
 modern inspect --env production
 ```
 
-## 配置类型
+## Configuration Type
 
-### SSR 配置
+### SSR Configuration
 
-如果项目开启了 SSR 能力，则在 `dist` 目录会另外生成一份 `webpack.ssr.inspect.js` 文件，对应 SSR 构建时的 webpack 配置。
+If the project has SSR enable, an additional `webpack.ssr.inspect.js` file will be generated in the `dist/`, corresponding to the webpack configuration at SSR build time.
 
-### Modern 配置
+### Modern Configuration
 
-如果项目开启了 [enableModernMode](/docs/configure/app/output/enable-modern-mode) 选项，则在 `dist` 目录会另外生成一份 `webpack.modern.inspect.js` 文件，对应现代浏览器的 webpack 配置。
+if project enable [enableModernMode](/docs/configure/app/output/enable-modern-mode), an additional `webpack.modern.inspect.js` file will be generated in the `dist/`corresponding to the webpack configuration at modern web build.

package/en/docusaurus-plugin-content-docs/current/apis/app/commands/lint.md

@@ -13,9 +13,9 @@ Options:
   -h, --help  display help for command
 ```
 
-运行 `ESLint` 检查代码语法情况， 通长情况下，我们只需要在 `git commit` 阶段通过 `lint-staged` 检查本次提交修改的部分代码。
+Run ESLint to check the syntax of the code. Normally, only the part of the code modified by this commit needs to be checked by `lint-staged` during the `git commit` phase.
 
-* `--no-fix` 参数设置后可以关闭自动修复 lint 错误代码的能力。
+* `--no-fix` close auto fix by lint.
 
 import CommandTip from '@site-docs/components/command-tip.md'
 

package/en/docusaurus-plugin-content-docs/current/apis/app/commands/new.md

@@ -5,27 +5,27 @@ sidebar_position: 2
 ```bash
 Usage: modern new [options]
 
-应用工程中执行生成器
+Execution Generator in App
 
 Options:
-  -d, --debug            开启 Debug 模式，打印调试日志信息 (default: false)
-  -c, --config <config>  生成器运行默认配置(JSON 字符串)
-  --dist-tag <tag>       生成器使用特殊的 npm Tag 版本
-  --registry             生成器运行过程中定制 npm Registry
-  -h, --help             显示命令帮助
+  -d, --debug            using debug mode to log something (default: false)
+  -c, --config <config>  set default generator config(json string)
+  --dist-tag <tag>       use specified tag version for its generator
+  --registry             set npm registry url to run npm command
+  -h, --help             show command help
 ```
 
-`modern new` 命令用于在已有项目中添加项目元素。
+The `modern new` command is used to enable features to an existing project.
 
-比如添加应用入口、启用启用一些可选功能如 Tailwind CSS、微前端开发模式等。
+For example, add application entry, enable some optional features such as Tailwind CSS, micro frontend, etc.
 
 import CommandTip from '@site-docs/components/command-tip.md'
 
 <CommandTip />
 
-### 添加入口
+### Add Entry
 
-在应用工程中，执行 `new` 命令添加入口如下：
+In the project, execute the `new` command to add entries as follows:
 
 ```bash
 $ npx modern new
@@ -35,9 +35,9 @@ $ npx modern new
 ? 是否需要调整默认配置? 否
 ```
 
-### 启用启用可选功能
+### Enable Features
 
-在应用工程中，执行 `new` 命令启用可选能力如下：
+In the project, execute the `new` command to enable features as follows:
 
 ```bash
 $ npx modern new
@@ -52,8 +52,8 @@ $ npx modern new
   启用「Visual Testing (Storybook)」模式
 ```
 
-:::caution 注意
-`--config` 参数对应参数值需要使用 JSON 字符串。
+:::caution
+The `--config` parameter needs to use a JSON string.
 
-pnpm 暂不支持使用 JSON 字符串作为参数值，可使用 `npm new` 开启相关功能。【[相关 Issue](https://github.com/pnpm/pnpm/issues/3876)】
+pnpm does not support the use of JSON strings as parameter values currently. Use `npm new` to turn on.【[Relate Issue](https://github.com/pnpm/pnpm/issues/3876)】
 :::

package/en/docusaurus-plugin-content-docs/current/apis/app/commands/start.md

@@ -8,14 +8,14 @@ Usage: modern start [options]
 start server
 
 Options:
-  -c --config <config>  指定配置文件路径，可以为相对路径或绝对路径
-  -h, --help            显示命令帮助
-  --api-only            仅启动 API 接口服务
+  -c --config <config>  configuration file path, which can be a relative path or an absolute path
+  -h, --help            show command help
+  --api-only            only start API service
 ```
 
-通常使用 `modern start` 命令在生产环境下启用应用工程, 需要提前执行 [`build`](/docs/apis/app/commands/build) 命令构建出对应产物。
+Usually use the `modern start` command to enable project start in the production environment, and you need to execute the [`build'](/docs/apis/app/commands/build) command in advance to build the product.
 
-默认情况下，应用将会在 `localhost:8080` 启动，可以通过 `server.port` 修改 Server 端口号：
+By default, the project will start in `localhost:8080`, you can modify the Server port number with `server.port`:
 
 ```js
 export default defineConfig({

package/en/docusaurus-plugin-content-docs/current/apis/app/commands/test.md

@@ -6,14 +6,14 @@ sidebar_position: 3
 Usage: modern test [options]
 
 Options:
-  -h, --help  显示命令帮助
+  -h, --help  show command help
 ```
 
-:::caution 注意
-`modern test` 命令需要先通过 [`new`](/docs/apis/app/commands/new) 命令启用「单元测试 / 集成测试」功能
+:::caution
+`modern test` command need to execute the `new` command in advance to enable the `unit test/integration test`.
 :::
 
-`modern test` 命令会自动运行项目下的测试用例，效果如下：
+`modern test` command will automatically run the test cases, the effect is as follows:
 
 ```bash
 $ npx modern test
@@ -28,7 +28,7 @@ Time:        0.994 s, estimated 1 s
 ```
 
 :::info
-`src` 和 `api` 目录下面 `*.test.(js|ts)` 都会默认识别为测试用例。
+files match `*.test.(js|ts)` in `api/` or `src/` will be recognized as test cases by default。
 :::
 
 import CommandTip from '@site-docs/components/command-tip.md'

package/en/docusaurus-plugin-content-docs/current/apis/app/commands/upgrade.md

@@ -5,19 +5,17 @@ sidebar_position: 8
 ```
 Usage: modern upgrade [options]
 
-升级 Modern.js 到最新版本
+upgrade Modern.js to latest version.
 
 Options:
-  --registry <registry>  定制 npm registry (default: "")
-  -d,--debug             开启 Debug 模式，打印调试日志信息 (default: false)
-  --cwd <cwd>            项目路径 (default: "")
-  -h, --help             display help for command
+  --registry <registry>  specify npm registry (default: "")
+  -d,--debug             using debug mode to log something (default: false)
+  --cwd <cwd>            app directory (default: "")
+  -h, --help             show command help
 ```
 
-`modern upgrade` 命令，用于升级项目 Modern.js 相关依赖至最新版本。
-
-在项目根目录下执行命令 `npx modern upgrade`，会默认将当前执行命令项目的 `package.json` 中的 Modern.js 相关依赖更新至最新版本。
+Execute the command `npx modern upgrade` in the project, by default, dependencies in the `package.json` are updated to the latest version.
 
 :::info
-命令在 `@modern-js/app-tools` 版本 >= 1.17.0 提供，之前版本可使用 `npx @modern-js/upgrade` 进行升级。
+the command is available in `@modern-js/app-tools` version >= 1.17.0, previous versions can be upgraded with `npx @modern-js/upgrade`.
 :::

package/en/docusaurus-plugin-content-docs/current/apis/app/hooks/_category_.json

@@ -1,5 +1,5 @@
 {
-  "label": "文件约定",
+  "label": "Convention",
   "position": 1,
   "link": {
     "type": "doc",

package/en/docusaurus-plugin-content-docs/current/apis/app/hooks/api/framework/lambda.md

@@ -3,77 +3,52 @@ title: lambda/*.[tj]s
 sidebar_position: 1
 ---
 
-声明 API 路由的文件，在 Modern.js 函数写法下；除了[某些约定文件](/docs/apis/app/hooks/api/framework/lambda#白名单)外，`api` 目录下的文件会被注册为接口的路由。
+Declaring API routing in BFF framework mode. Except [some files](/docs/apis/app/hooks/api/framework/lambda#allow-list)，files in `api/` are registered as routes.
 
 :::info
-使用 `api` 目录需要开启 BFF 功能，需要在项目下执行 new 命令启用「BFF」功能。
+use `api/` need execute new command to enable the 「BFF」 feature.
+:::
 
-该文件支持使用 `js` 或 `ts` 语言，但必须使用 `esm` 语法导出函数。
+:::tip
+this file supports the use `js` or `ts`, but the functions must be exported using the ESM syntax.
 :::
 
-## 路由规则
+## Routing Rule
 
-### 默认路由
+### Default Route
 
-路由系统会将以 `index` 命名的文件会被映射到上一层目录。
+The files named `index` will be upper level routing:
 
 * `api/lambda/index.ts` -> `$BASENAME/`
 * `api/lambda/user/index.ts` -> `$BASENAME/user`
 
-### 嵌套路由
+### Multi Level Route
 
-路由系统也支持解析嵌套的文件，如果创建嵌套文件夹结构，文件仍会以相同方式自动解析路由。
+The routing system also supports parsing multiple levels of files. and if you create a folder, the files will still be automatically parsed in the same way.
 
 * `api/lambda/hello.ts` -> `$BASENAME/hello`
 * `api/lambda/user/list.ts` -> `$BASENAME/user/list`
 
-### 动态路由
+### Dynamic Route
 
-同样的，你可以通过创建带有 `[xxx]` 的文件夹或者文件来支持动态的命名路由参数。
+Dynamic named routing parameters can be supported by creating folders or files with `[xxx]`.
 
 * `api/lambda/user/[username]/info.ts` -> `$BASENAME/user/:username/info`
 * `api/lambda/user/[username]/delete.ts` -> `$BASENAME/user/:username/delete`
 * `api/lambda/article/[id]/info.ts` -> `$BASENAME/article/:id/info`
 
-其中的 `$BASENAME` 可以在 `modern.config.js` 中进行配置，默认值为 `/api`。
-
-### 白名单
-
-默认 `api` 目录下所有文件都会当作 BFF 函数文件去解析，但同样我们也设置了白名单，这些文件不被被解析：
-
-* 命名以 `_` 开头的文件。例如：`_utils.ts`。
-* 命名以 `_` 开头的文件夹下所有文件。例如：`_utils/index.ts`、`_utils/cp.ts`。
-* 测试文件。例如：`foo.test.ts`。
-* TypeScript 类型文件。例如：`hello.d.ts`。
-* `node_module` 下的文件。
-
-## 函数定义
-
-除了上面的路由规则之外，代码中函数定义与导出也有相应的约定。
+the `$BASENAME` can be configured in `modern.config.js`，the default value is `/api`。
 
-* 首先命名导出时，导出函数的名字为对应接口接受的 HTTP Method。
+### Allow List
 
-即：
+By default, all files in the `api/` will be parsed as BFF function. but we also set a allow list, and these files will not be parsed:
 
-```ts
-export const get = async () => {
-  return {
-    name: 'Modern.js',
-    desc: '现代 web 工程方案',
-  };
-};
-```
+* file name start with `_`, for example: `_utils.ts`.
+* files in directory that name start with `_`, for example：`_utils/index.ts`、`_utils/cp.ts`.
+* test files, for example：`foo.test.ts`.
+* TypeScript define files, for example：`hello.d.ts`.
+* files in `node_module`.
 
-这样导出函数，则会得到一个 `POST` 接口。
+## Define Function
 
-应用工程中支持了 9 个 Method 定义，即：`GET`、`POST`、`PUT`、`DELETE`、`CONNECT`、`TRACE`、`PATCH`、`OPTION`、`HEAD`，即可以用这些 Method 作为函数导出的名字。
-
-名字是大小不敏感的，就是说，如果是 `GET`，写成 `get`、`Get`、`GEt`、`GET`，都可以准确识别。而默认导出，即 `export default xxx` 则会被映射为 `Get`。
-
-因为 `delete` 是 `javascript` 中的关键字，可以使用 `del` 或者 `DELETE` 代替。
-
-可以在一个文件中定义多个不同 Method 的函数，但如果定义多个相同 Method 的函数，则只有第一个会生效。
-
-:::info
-需要注意的是，定义的函数都应该是异步的，这个与函数调用时类型有关，这个后面会提到。
-:::
+the same as [Define Function](/docs/apis/app/hooks/api/functions/api#define-function).

package/en/docusaurus-plugin-content-docs/current/apis/app/hooks/api/functions/api.md

@@ -3,48 +3,76 @@ title: "**/*.[tj]s"
 sidebar_position: 1
 ---
 
-声明 API 路由的文件，在 Modern.js 函数写法下；除了[某些约定文件](/docs/apis/app/hooks/api/functions/api)外，`api` 目录下的文件会被注册为接口的路由。
+Declaring API routing in BFF function mode. Except [some files](/docs/apis/app/hooks/api/functions/api#allow-list)，files in `api/` are registered as routes.
 
 :::info
-使用 `api` 目录需要开启 BFF 功能，需要在项目下执行 new 命令启用「BFF」功能。
+use `api/` need execute new command to enable the 「BFF」 feature.
+:::
 
-该文件支持使用 `js` 或 `ts` 语言，但必须使用 `esm` 语法导出函数。
+:::tip
+this file supports the use `js` or `ts`, but the functions must be exported using the ESM syntax.
 :::
 
-## 该文件约定路由如下：
+## Routing Rule
 
-### 默认路由
+### Default Route
 
-路由系统会将以 `index` 命名的文件会被映射到上一层目录。
+The files named `index` will be upper level routing:
 
 * `api/index.ts` -> `$BASENAME/`
 * `api/user/index.ts` -> `$BASENAME/user`
 
-### 嵌套路由
+### Multi Level Route
 
-路由系统也支持解析嵌套的文件，如果创建嵌套文件夹结构，文件仍会以相同方式自动解析路由。
+The routing system also supports parsing multiple levels of files. and if you create a folder, the files will still be automatically parsed in the same way.
 
 * `api/hello.ts` -> `$BASENAME/hello`
 * `api/user/list.ts` -> `$BASENAME/user/list`
 
-### 动态路由
+### Dynamic Route
 
-同样的，你可以通过创建带有 `[xxx]` 的文件夹或者文件来支持动态的命名路由参数。
+Dynamic named routing parameters can be supported by creating folders or files with `[xxx]`.
 
 * `api/user/[username]/info.ts` -> `$BASENAME/user/:username/info`
 * `api/user/[username]/delete.ts` -> `$BASENAME/user/:username/delete`
 * `api/article/[id]/info.ts` -> `$BASENAME/article/:id/info`
 
-其中的 `$BASENAME` 可以在 `modern.config.js` 中进行配置，默认值为 `/api`。
+the `$BASENAME` can be configured in `modern.config.js`，the default value is `/api`。
+
+### Allow List
+
+By default, all files in the `api/` will be parsed as BFF function. but we also set a allow list, and these files will not be parsed:
+
+* file name start with `_`, for example: `_utils.ts`.
+* files in directory that name start with `_`, for example：`_utils/index.ts`、`_utils/cp.ts`.
+* test files, for example：`foo.test.ts`.
+* TypeScript define files, for example：`hello.d.ts`.
+* files in `node_module`.
+
+## Define Function
 
-### 白名单
+In addition to the above routing rules, the function definition and export in the code also have conventions.
 
-默认 `api` 目录下所有文件都会当作 BFF 函数文件去解析，但同样我们也设置了白名单，这些文件不被被解析：
+function need named exports，and the name of the exported function is the HTTP Method:
 
-* 命名以 `_` 开头的文件。例如：`_utils.ts`。
-* 命名以 `_` 开头的文件夹下所有文件。例如：`_utils/index.ts`、`_utils/cp.ts`。
-* 测试文件。例如：`foo.test.ts`。
-* TypeScript 类型文件。例如：`hello.d.ts`。
-* `node_module` 下的文件。
+```ts
+export const get = async () => {
+  return {
+    name: 'Modern.js',
+    desc: 'Modern web Solutions',
+  };
+};
+```
 
+Export the function like above will generate a `POST` interface.
 
+App support 9 Method definitions: `GET`、`POST`、`PUT`、`DELETE`、`CONNECT`、`TRACE`、`PATCH`、`OPTION`、`HEAD`. so App can use these name as function export nane.
+
+The name is insensitive, whaterver `get`、`Get`、`GEt`、`GET`, can be accurately identified. And default export, `export default xxx` will be `Get` method.
+
+because `delete` is a keyword in JavaScript, use `del` or `DELETE` instead.
+
+Multiple functions of different Methods can be defined in one file, but if multiple functions of the same Method are defined, only the first can work.
+
+:::info
+It should be noted that the defined functions should be asynchronous, which is related to the type when the function is called.

package/en/docusaurus-plugin-content-docs/current/apis/app/hooks/api/functions/app.md

@@ -3,10 +3,10 @@ title: _app.[tj]s
 sidebar_position: 3
 ---
 
-在函数写法下，该文件可以为 [BFF 函数](/docs/apis/app/hooks/api/functions/api)添加前置中间件。
+in BFF function mode，this file can add middleware before [BFF 函数](/docs/apis/app/hooks/api/functions/api).
 
 :::note
-具体示例请参考 [hook](/docs/apis/app/runtime/bff/hook)
+For detail, see [hook](/docs/apis/app/runtime/bff/hook)
 :::
 
 

package/en/docusaurus-plugin-content-docs/current/apis/app/hooks/api/functions/common.md

@@ -3,8 +3,8 @@ title: "**/_*.[tj]s, _*/**"
 sidebar_position: 2
 ---
 
-在 Modern.js 函数写法下，这些文件不会注册为路由；你可以在这种目录或文件下放任意项目中需要的代码，文件等。
+under BFF function mode, these files are not registered as routes.
+
+Any files that not routes, but required in the project can be named in this way.
+
 
-:::info
-使用 `api` 目录的开启 BFF 功能，需要在项目下执行 new 命令启用「BFF」功能。
-:::

package/en/docusaurus-plugin-content-docs/current/apis/app/hooks/api/test.md

@@ -3,10 +3,8 @@ title: test.[tj]s
 sidebar_position: 2
 ---
 
-应用项目 BFF 测试文件。
-
-应用项目支持在项目 API 目录下创建后缀为 `.test.[tj]sx?` 文件进行编写测试用例。
+App's BFF test file，support for writing test cases in the `api/` directory which file with suffix `.test.[tj]s`.
 
 :::info
-使用单元测试、集成测试需要提前在项目下执行 new 命令启用「单元测试 / 集成测试」功能。
+To use unit test and integration test, you need to execute the `new` command in advance to enable the `unit test/integration test`.
 :::

package/en/docusaurus-plugin-content-docs/current/apis/app/hooks/config/html.md

@@ -3,8 +3,6 @@ title: html/
 sidebar_position: 1
 ---
 
-应用工程方案自定义 html 片段文件。
+The `config/html` directory allows you to inject custom html snippets in different places in the default html template.
 
-通过 `config/html` 目录可以在内部默认 html 模板的不同位置注入自定义的 html 片段。
-
-具体使用方式请参考: [自定义 HTML](/docs/guides/basic-features/html)
+For detail, see [HTML](/docs/guides/basic-features/html).

package/en/docusaurus-plugin-content-docs/current/apis/app/hooks/config/icon.md

@@ -3,15 +3,13 @@ title: icon.png
 sidebar_position: 2
 ---
 
-应用工程方案 App Icon 文件。
-
-项目根目录下 `config/icon.png` 时，可以在构建时在 html 页面注入 app icon 信息, 如下:
+When `config/icon.png` exist, it can inject app icon information into the html page at build time:
 
 ```
-./config
+.config
 └── icon.png
 ```
 
-最终 html 中会注入 app icon `link` 标签, 如下:
+the app icon `link` meta will be injected into the html, as follows:
 
 ![app-icon](https://lf3-static.bytednsdoc.com/obj/eden-cn/aphqeh7uhohpquloj/modern-js/api/app-icon.png)

package/en/docusaurus-plugin-content-docs/current/apis/app/hooks/config/mock.md

@@ -3,10 +3,4 @@ title: mock/
 sidebar_position: 5
 ---
 
-应用工程方案本地调试 Mock 数据文件。
-
-项目根目录下存在 `config/mock/index.js` 时，在本地开发调试环节自动启用快速 Mock 数据的功能。
-
-:::caution 注意
-为避免 Mock API 不生效， 请注意不要与配置 [tools.devServer.proxy](/docs/configure/app/tools/dev-server) 的 API 有冲突。
-:::
+when `config/mock/index.js` exist，Modernjs auto start the Mock service in the development.