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

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

@@ -3,28 +3,26 @@ title: public/
 sidebar_position: 3
 ---
 
-应用工程方案静态资源文件。
+Static resource files in any format can be placed in the `public/`, and the files will be Served under the web application domain name.
 
-`public/` 目录中可以放置任意格式的静态资源文件，文件会被 Serve 在 Web 应用域名下。
+## Description
 
-## 说明
+The routing of files to be served is based on the convention of the file system. `public/` is the root directory, which corresponds to the root path of the Web application.
 
-被 Serve 的文件路由基于目录结构的约定，其中，`public/` 为根目录，对应 Web 应用根域名。
+For example, the `config/public/sdk/index.js` file will be Served under `${domain}/sdk/index.js` after deployment.
 
-例如 `config/public/sdk/index.js` 文件，在部署后将会被 Serve 在 `${domain}/sdk/index.js` 下。
+## Scene
 
-## 场景
+For example, `robots.txt`, `auth.xml` and other authentication file.
 
-例如 `robots.txt`，`auth.xml` 等第三方系统需要的认证文件。
-
-或者是给其他业务方（要求路由不变）的 SDK，也可以是无需入口的 HTML 文件等。
+SDK (requiring the same routing) for other business, or an HTML file for static host.
 
 :::info
-对于需要在源码中通过 import 引用的静态资源（比如 SVG 图片），建议放到 `src/assets` 目录下进行管理。
+For static resources (such as SVG pictures) that need to be referenced by import in the source code, it is recommended to put them in the `src/assets/` for management.
 :::
 
-## 代码压缩
+## Compression
 
-如果目录下的文件是一个 `.js` 文件，在生产环境构建时，会自动对其进行代码压缩。
+If the file is a `.js` file, it will be automatically compressed when the production environment is built.
 
-如果该文件以 `.min.js` 结尾，则不会经过代码压缩处理。
+If the file ends with `.min.js`, it will not compression.

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

@@ -3,12 +3,10 @@ title: storybook/
 sidebar_position: 7
 ---
 
-应用工程方案 Storybook 配置文件。
+Modern.js.js supports debugging with Storybook. When you need to configure Storybook, configure it in the `config/storybook/`.
 
-应用工程方案支持使用 Storybook 进行调试，当需要对 Storybook 进行配置时，需要在项目 config/storybook 目录进行配置。
-
-Storybook 配置请查看：[Storybook 配置](https://storybook.js.org/docs/react/configure/overview)
+For detail, see [Storybook](https://storybook.js.org/docs/react/configure/overview).
 
 :::info
-使用 Storybook 进行调试需要提前在项目下执行 new 命令启用「Visual Testing (Storybook)」模式功能。
+Debugging with Storybook requires executing the `new` command to enable the 「Visual Testing (Storybook)」 mode feature.
 :::

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

@@ -3,46 +3,40 @@ title: upload/
 sidebar_position: 4
 ---
 
-应用工程方案静态资源文件。
+Static resource files in any format can be placed in the `upload/`.
 
-`upload/` 目录中可以放置任意格式的静态资源文件。
+## Description
 
-## 说明
+In the development environment, the static resource files in this directory will be hosted in the '/upload' path. After building the application product, the files in this directory will be copied to the dist path.
 
-在开发环境下，该目录下的静态资源文件会被托管在 `/upload` 路径下。构建应用产物后，该目录下的文件会被复制到产物目录中。
+This file convention is mainly used for developers to use plugins to upload static resource files to the CDN.
 
-该文件约定主要用于开发者使用插件，主动上传静态资源文件到 CDN。
+## Scene
 
-## 场景
+For example, the SDK used by the project such as `google-analysis.js` (usually requires http caching).
 
-例如 `google-analysis.js` 等项目自用的 SDK（通常需要 http 缓存）。
+Images, font files, generic CSS, etc.
 
-图片、字体文件、通用 CSS 等。
+## Compression
 
-如果并非必要，Modern.js 推荐将 JS / CSS 这类文件通过 `upload/` 上传到 CDN，而不使用 `public/`。
+If the file is a `.js` file, it will be automatically compressed when the production environment is built.
 
-## 代码压缩
+If the file ends with `.min.js`, it will not compression.
 
-如果目录下的文件是一个 `.js` 文件，在生产环境构建时，会自动对其进行代码压缩。
+## More Usage
 
-如果该文件以 `.min.js` 结尾，则不会经过代码压缩处理。
-
-## 更多用法
-
-不论是在[自定义 HTML](/docs/guides/basic-features/html) 中，或是在 [`config/public/`](/docs/apis/app/hooks/config/public) 下的任意 HTML 文件中，都可以直接使用 HTML 标签引用 `config/upload/` 目录下的资源：
+Whether in [custom HTML](/docs/guides/basic-features/html), or in any HTML file under ['config/public/'](/docs/apis/app/hooks/config/public), you can directly use the HTML tag to refer to the resources in the `config/upload/`:
 
 ```html
 <script src="/upload/index.js"></script>
 ```
 
-如果设置了 [`output.assetPrefix`](/docs/configure/app/output/asset-prefix) 前缀，也可以直接使用模板语法添加该前缀：
+if [`output.assetPrefix`](/docs/configure/app/output/asset-prefix) is configured，add this prefix directly using template syntax:
 
 ```html
 <script src="<%=assetPrefix %>/upload/index.js"></script>
 ```
 
 :::info
-Modern.js 没有支持在 `config/public/*.css`（例如 background-image）中通过 URL 使用 `config/upload/` 下的文件。
-
-因为 Modern.js 不推荐在 `public/` 中放 JS、CSS 这类资源文件，可以将它们直接放置在 `upload/` 目录下。
+Modern.js does not support the use files under `upload/` in `config/public/*.css` via URL.
 :::

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

@@ -2,11 +2,6 @@
 type: ref
 ---
 
-# 文件约定
-
-本节涵盖了使用应用工程的所有文件约定。
-
-
-
-
+# Convention
 
+This section covers all documentation conventions.

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

@@ -3,8 +3,6 @@ title: modern.config.js
 sidebar_position: 8
 ---
 
-应用工程方案的 Modern.js 配置文件。
+Modern.js config file, through which you can confiured all aspects of the current project.
 
-通过该文件可以对当前项目的各个方面进行个性化配置。
-
-了解配置的具体用法，请参考 [配置使用](/docs/configure/app/usage)。
+For detail, see [configure](/docs/configure/app/usage).

package/en/docusaurus-plugin-content-docs/current/apis/app/hooks/server/index_.md

@@ -3,10 +3,12 @@ title: index.[tj]s
 sidebar_position: 1
 ---
 
-扩展 Modern.js Server 的文件，在此文件中可以给应用工程启动的 Web Server 添加前置中间件。
+A file that extends the Modern.js Web Server, to add a Hook or Middleware to the Web Server that the project uses.
 
-可以对请求和响应进行拦截处理，鉴权与角色、请求预处理、异常兜底等；也可在 Server 的运行流程中（包括路由匹配、资源寻址、头部注入、页面渲染，静态 Web 托管）插入特定的业务逻辑。
+It can intercept requests and responses, authenticate and role, request preprocessing, exception bottom-up, etc.;
+
+It can also be inserted logic into the built-in processing handler (including route matching, resource addressing, header injection, page rendering, static web hosting).
 
 :::info
-具体使用示例可查看 [Hook](/docs/apis/app/runtime/web-server/hook)。
+For detail, see [Hook](/docs/apis/app/runtime/web-server/hook) & [Middleware](/docs/apis/app/runtime/web-server/middleware)。
 :::

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

@@ -3,10 +3,8 @@ title: test.[tj]s
 sidebar_position: 2
 ---
 
-扩展 Web Server 测试目录。
-
-应用项目支持对扩展 Web Server 逻辑进行测试，可直接在项目 server 目录下创建后缀为 `.test.[tj]s` 文件进行编写测试用例。
+App's Web Server test file，support for writing test cases in the `server/` 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/shared.md

@@ -3,6 +3,4 @@ title: shared/
 sidebar_position: 5
 ---
 
-应用工程方案共享源码目录。
-
-在项目中同时用到了 BFF 和扩展 Web Server 功能，并且它们之间存在一些公共服务端代码时，可将这些公共代码放到 shared 目录下。
+Shared directory. When the project has common code under `api/`, `server/`, `src/`, put the code under this directory rather then import directly.

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

@@ -3,13 +3,14 @@ title: App.[tj]sx
 sidebar_position: 1
 ---
 
-应用项目无路由或者任意路由的入口标识。
+Entry identifier if App want control route by code.
 
-开发单页面应用的场景，推荐 `src` 文件夹下放置 `App.[tj]sx` 导出应用根组件即可，Modern.js 会自动生成真正的构建打包的入口文件, 内容大致如下:
+`App.[tj]sx` is not the actual App entry, Modern.js will auto generate the entry file, the content is roughly as follows:
 
 ```js
 import React from 'react';
 import { createApp, bootstrap } from '@modern-js/runtime';
+// App.[jt]sx
 import App from '@_modern_js_src/App';
 import { state } from '@modern-js/runtime/plugins';
 import { immer, effects, autoActions, devtools } from '@modern-js/runtime/model';
@@ -38,4 +39,7 @@ AppWrapper = render();
 export default AppWrapper;;
 ```
 
-开发多页面应用的场景类似，在入口目录下推荐直接放置 `App.[jt]sx`, 自动生成的构建打包入口文件和单页面应用类似。
+:::note
+In multi-entry App，each entry can have a `App.[jt]sx`, for detail, see [Entry](/docs/guides/concept/entries).
+:::
+

package/en/docusaurus-plugin-content-docs/current/apis/app/hooks/src/index_.md

@@ -3,13 +3,14 @@ title: index.[tj]s
 sidebar_position: 3
 ---
 
-应用项目自定义路由入口标识。
+Entry identifier if App want use custom entry. In most case, [`App.[tj]sx`](/docs/apis/app/hooks/src/app) hook file can already meet our needs.
 
-通常情况下 [`src/App.[tj]sx, src/[entry]/App.[tj]sx`](/docs/apis/app/hooks/src/app) 钩子文件已经能满足我们的需求，当我们需要在 `bootstrap` 之前添加自定义行为或者完全接管 webpack 打包入口时，可以在 `src` 或者入口目录下放置 `index.[tj]s`。 下面有分两种情况进行讨论:
+When we need to add custom behavior before `bootstrap` or completely take over the webpack entry, we can place `index.[tj]s` in `src/` or entry directory. The following are discussed in two cases:
 
-1. bootstrap 之前添加自定义行为：
 
-只需要 `src/index.[tj]s` 默认导出函数:
+1. add custom behavior before bootstrap
+
+Just add default export under `src/index.[tj]s`:
 
 ```js title=src/index.js
 import { bootstrap } from '@modern-js/runtime';
@@ -20,11 +21,9 @@ export default App => {
 };
 ```
 
+2. Fully take over the webpack entry
 
-2. 完全接管 webpack 入口:
-
-当 `src/index.[tj]sx?` 下没有默认导出函数时，该文件即为真正的 webpack 打包入口文件, 可以直接像使用 create-react-app 等脚手架一样组织代码:
-
+When there is no default export function under `src/index.[tj]sx?`, this file is the real webpack entry file, and the code can be organized such as create-react-app:
 
 ```js title=src/index.jsx
 import React from 'react';

package/en/docusaurus-plugin-content-docs/current/apis/app/hooks/src/pages.md

@@ -3,12 +3,11 @@ title: pages/
 sidebar_position: 2
 ---
 
-应用项目基于文件系统路由的入口标识。
+Entry identifier if the application want uses file system-based routing.
 
-当项目结构为 `Pages 入口` 类型时， 会分析 `src/pages` 目录下的文件得到客户端路由配置。
+When the entry is the **Pages entry** type, the files in the `pages/` directory will be analyzed to client side routing.
 
-
-举例说明，例如以下目录结构：
+For example, the following directory:
 
 ```bash
 .
@@ -20,7 +19,7 @@ sidebar_position: 2
         └── info.jsx
 ```
 
-对应生成的路由配置为:
+The generated route is configured as:
 
 ```bash
 [
@@ -30,23 +29,21 @@ sidebar_position: 2
 ]
 ```
 
-pages 目录下的文件满足以下条件的不会被当做路由文件
-
-- 后缀不是 `.(j|t)sx?` 的文件。
-- `.d.ts` 类型定义文件。
-- 以 `.(test|spec|e2e).(j|t)sx?` 结尾的测试文件。
-
-:::tip 提示
+Files match the following conditions will not be treated as routing files:
 
-推荐 pages 目录下只写入口代码，把业务逻辑写到 pages 外面独立的 features 目录里。这样 pages 目录下大部分文件都会是路由文件，也就不需要额外的过滤规则。
+- suffix is not `.(j|t)sx?`.
+- `.d.ts` type definition file.
+- test file suffix like `.(test|spec|e2e).(j|t)sx?`.
 
+:::tip
+it is recommended to write only the routing files in the `pages/`, and write the business logic to the independent features directory outside the `pages/`. In this way, most of the files in the pages directory will be routing files, and there is no need for additional filtering rules.
 :::
 
-### 动态路由
+### Dynamic Routing
 
-使用 `[ ]` 包裹的目录或文件会被视为动态路由
+Directories or files wrapped with `[]` are considered dynamic routing.
 
-例如以下目录结构:
+For example the following directory structure:
 
 ```bash
 .
@@ -61,7 +58,7 @@ pages 目录下的文件满足以下条件的不会被当做路由文件
         └── info.jsx
 ```
 
-对应生成的路由配置为:
+The generated route is configured as:
 
 ```js
 [
@@ -73,13 +70,13 @@ pages 目录下的文件满足以下条件的不会被当做路由文件
 ]
 ```
 
-动态路由的基础上，支持添加特殊的路由后缀 `(*、?、+)`。
+Basis dynamic routing, it supports adding special routing suffixes `(*、?、+)`.
 
-例如：`src/pages/users/[id]*.tsx` 最终路由为 `/users/:id*`
+For example: `src/pages/users/[id]*.tsx` generate route `/users/:id*`
 
-### 全局 layout
+### Global Layout
 
-整个应用需要全局的 `layout` 时， 可以通过 `pages/_app.tsx` 实现，具体写法如下:
+When the entire App needs a global `layout`, it can be achieved through `pages/_app.tsx`, which as follows:
 
 ```js
 import React from 'react';
@@ -94,9 +91,9 @@ export default const App = ({Component, ...pageProps}:{ Component: React.Compone
 }
 ```
 
-上述 `App` 为访问具体路由匹配到的组件。
+The above `Component` is the component to which the route is accessed.
 
-例如以下目录结构:
+For example the following directory structure:
 
 ```bash
 .
@@ -108,26 +105,26 @@ export default const App = ({Component, ...pageProps}:{ Component: React.Compone
     └── index.js
 ```
 
-- 访问 `/` 时，对应的 `Component` 组件为 `pages/index.js`。
-- 访问 `/a` 时，对应的 `Component` 组件为 `pages/a/index.js`。
-- 访问 `/a/b` 时，对应的 `Component` 组件为 `pages/a/b/index.js`。
+- access `/`, the `Component` is `pages/index.js`。
+- access `/a`, the `Component` is `pages/a/index.js`。
+- access `/a/b`, the `Component` is `pages/a/b/index.js`。
 
-:::tip 全局 layout 有以下优点
+:::tip Advantages
 
-- 页面变化时，保留全局布局的状态
-- 添加全局样式
-- ComponentDidCatch 错误处理
-- 使用 `defineConfig`(/docs/apis/app/runtime/app/define-config) 动态配置运行时配置。
+- preserve the state of the global layout when the page changes.
+- add global css.
+- handle ComponentDidCatch error
+- use `defineConfig`(/docs/apis/app/runtime/app/define-config) dynamic configuration runtime.
 
 :::
 
-### 部分 layout
+### Partial Layout
 
-开发应用时，存在同一路由下的子路由共用 layout 的场景。
+When developing an App, where sub routes under the same route may share the layout.
 
-针对这一场景，Modern.js 约定，当目录下存在 `_layout.js` ，就会有类似全局 layout 的效果。
+For this scene, Modern.js convention, when there is a `_layout.js` in the directory, the routes can shared this layout.
 
-例如以下目录结构:
+For example the following directory structure:
 
 ```bash
 └── pages
@@ -148,18 +145,18 @@ const ALayout = ({ Component, ...pageProps }) => {
 export default ALayout;
 ```
 
-Component 参数为访问具体路由对应的组件，例如
+The Component props is the specific route, for example
 
-- 访问 `/a` 时，对应的 `Component` 组件为 `pages/a/index.js`。
-- 访问 `/a/b` 时，对应的 `Component` 组件为 `pages/a/b/index.js`。
+- access `/a`, the `Component` is `pages/a/index.js`。
+- 访问 `/a/b`, the `Component` is `pages/a/b/index.js`。
 
-这样就可以用 `pages/a/_layout.js` 满足 `a` 目录下路由共用 layout 的需求。
+In this way, you can use `pages/a/_layout.js` to display the routing common layout in the `a` directory.
 
 ### 404 路由
 
-约定 `pages/404.[tj]sx` 为默认的 404 路由。
+The convention `pages/404.[tj]sx` is the default 404 route.
 
-例如以下目录结构:
+For example the following directory structure:
 
 ```bash
 .
@@ -170,7 +167,7 @@ Component 参数为访问具体路由对应的组件，例如
         ├── 404.js
 ```
 
-生成路由配置如下:
+the generated route is configured is as:
 
 ```bash
 [
@@ -180,4 +177,4 @@ Component 参数为访问具体路由对应的组件，例如
 ]
 ```
 
-所有未匹配的路由，都将匹配到 `pages/404.[tj]s`。
+All unmatched routes will match to `pages/404.[tj]s`。

package/en/docusaurus-plugin-content-docs/current/apis/app/hooks/src/stories.md

@@ -3,12 +3,10 @@ title: "**/*.stories.[tj]sx"
 sidebar_position: 7
 ---
 
-应用项目 Storybook 调试文件。
+App Storybook debug file. files in `src/` which suffix `*.stories.[tj]sx` are as debug files for Storybook.
 
-可以在项目源码目录(src)下创建 `*.stories.[tj]sx` 格式的文件作为 Storybook 的调试文件。
-
-在项目下执行 dev story 命令，支持使用这些文件在 Storybook 中对相关内容进行调试。
+Execute the `dev story` command to debugging these files in the Storybook.
 
 :::info
-使用 Storybook 需要提前在项目下执行 new 命令启用「Visual Testing (Storybook)」模式。
+Using a Storybook requires executing `new` command  to enable the 「Visual Testing (Storybook)」 mode.
 :::

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

@@ -3,10 +3,10 @@ title: "**/*.test.[tj]sx?"
 sidebar_position: 6
 ---
 
-应用项目测试文件。
+App test file.
 
-应用项目支持在项目源码目录(src)下创建后缀为 `.test.[tj]sx?` 文件进行编写测试用例。
+The App supports the file suffixed with `.test.[tj]sx` under the `src/` to write test cases.
 
 :::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/overview.md

@@ -2,8 +2,9 @@
 sidebar_position: 0
 ---
 
-# 概览
-本节涵盖了使用 `@modern-js/app-tools` 的所有API。
+# Overview
+
+This section covers all APIs in `@modern-js/app-tools`.
 
 import OverviewNav from '@site/src/components/OverviewNav';
 import sidebarData from '@site/plugins/overview-loader!@site/plugins/overview-data.json';

package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/app/define-config.md

@@ -52,9 +52,9 @@ defineConfig(App, {
 
 ```json
 {
-  // 来自 `modern.config.js` 配置
+  // 来自 `modern.config.js`
   ...runtime.router
-  // 来自 `defineConfig` 配置
+  // 来自 `defineConfig`
   ...config.router
 }
 ```

package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/default-alias.md

@@ -21,6 +21,5 @@ The following example shows how to reference a function by default alias.
 import { hello } from '@/common/utils';
 
 hello();
-
 ```
 A reference to `@/common/utils` is equal to a reference to `src/common/utils`.

package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/env.md

@@ -45,7 +45,7 @@ REACT_APP_FOO=123 BAR=456 pnpm run dev
 
 ### Specify Via File
 
-Create a `.env` file in the App root directory with custom environment variables:
+Create a `.env` file in the project with custom environment variables:
 
 ```env
 REACT_APP_FOO=123

package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/model/model_.md

@@ -56,8 +56,8 @@ const fooModel = model('foo').define({
 
 `function define((context: Context, utils: Utils) => ModelDesc): Model;`
 
-- context: Context，Reduck 上下文对象，可以获取底层的 `store` 对象。`store` 除支持 Redux Store 的所有 [API](https://redux.js.org/api/store) 以外，还挂载了用于消费 Model 的 `use` 的方法，和用于卸载 Model 的 `unmount` 方法。
-- utils: Utils，定义 Model 时，常用的工具函数: `use`、`onMount`。`use` 作用同 `store` 对象上的 `use`，`onMount` 是 Model 挂载后的钩子函数。
+- `context`: Reduck Context, can get underlying `store` object. `store` support all Redux Store [API](https://redux.js.org/api/store), also mounts the `use` method for consuming the Model, and the `unmount` method for unmounting the Model.
+- utils: commonly used tool like `use`、`onMount`. `use` is the same as `store.use`，`onMount` is the hook function after the Model is mounted.
 
 <!-- TODO: @anchao 调整类型 -->
 ```ts

package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/testing/act.md

@@ -12,7 +12,7 @@ import { act } from '@modern-js/runtime/testing';
 
 ## Function Signature
 
-`act` is the same as [react-dom/test-utils act 函数](https://reactjs.org/docs/testing-recipes.html#act).
+`act` is the same as [react-dom/test-utils act function](https://reactjs.org/docs/testing-recipes.html#act).
 
 ## Example
 

package/en/docusaurus-plugin-content-docs/current.json

@@ -112,8 +112,8 @@
     "description": "The label for category 常见问题 in sidebar guidesSidebar"
   },
   "sidebar.apisAppSidebar.category.文件约定": {
-    "message": "文件约定",
-    "description": "The label for category 文件约定 in sidebar apisAppSidebar"
+    "message": "Convention",
+    "description": "The label for category convention in sidebar apisAppSidebar"
   },
   "sidebar.apisAppSidebar.category.src/": {
     "message": "src/",
@@ -124,12 +124,12 @@
     "description": "The label for category api/ in sidebar apisAppSidebar"
   },
   "sidebar.apisAppSidebar.category.函数写法": {
-    "message": "函数写法",
-    "description": "The label for category 函数写法 in sidebar apisAppSidebar"
+    "message": "Function",
+    "description": "The label for category Function in sidebar apisAppSidebar"
   },
   "sidebar.apisAppSidebar.category.框架写法": {
-    "message": "框架写法",
-    "description": "The label for category 框架写法 in sidebar apisAppSidebar"
+    "message": "Framework",
+    "description": "The label for category Framework in sidebar apisAppSidebar"
   },
   "sidebar.apisAppSidebar.category.server/": {
     "message": "server/",
@@ -141,11 +141,11 @@
   },
   "sidebar.apisAppSidebar.category.命令": {
     "message": "Commands",
-    "description": "The label for category 命令 in sidebar apisAppSidebar"
+    "description": "The label for category command in sidebar apisAppSidebar"
   },
   "sidebar.apisAppSidebar.category.运行时": {
     "message": "Runtime",
-    "description": "The label for category 运行时 in sidebar apisAppSidebar"
+    "description": "The label for category runtime in sidebar apisAppSidebar"
   },
   "sidebar.apisAppSidebar.category.核心 API": {
     "message": "Core API",
@@ -188,8 +188,8 @@
     "description": "The label for category 插件 API in sidebar apisAppSidebar"
   },
   "sidebar.apisMonorepoSidebar.category.文件约定": {
-    "message": "文件约定",
-    "description": "The label for category 文件约定 in sidebar apisMonorepoSidebar"
+    "message": "Convention",
+    "description": "The label for category convention in sidebar apisMonorepoSidebar"
   },
   "sidebar.apisMonorepoSidebar.category.命令": {
     "message": "命令",

package/package.json

@@ -11,20 +11,20 @@
     "modern",
     "modern.js"
   ],
-  "version": "0.0.0-next-20221123182933",
+  "version": "0.0.0-next-20221124071519",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
   "peerDependencies": {
-    "@modern-js/builder-doc": "0.0.0-next-20221123182933"
+    "@modern-js/builder-doc": "0.0.0-next-20221124071519"
   },
   "devDependencies": {
     "ts-node": "^10",
     "fs-extra": "^10",
     "@types/node": "^16",
     "@types/fs-extra": "^9",
-    "@modern-js/builder-doc": "0.0.0-next-20221123182933"
+    "@modern-js/builder-doc": "0.0.0-next-20221124071519"
   },
   "scripts": {
     "build": "npx ts-node ./scripts/sync.ts"

package/zh/apis/app/commands/build.md

@@ -13,7 +13,7 @@ Options:
   --analyze   分析构建产物体积，查看各个模块打包后的大小
 ```
 
-`modern build` 命令默认会在 `/dist` 目录下构建出可用于生产环境的产物。
+`modern build` 命令默认会在 `dist/` 目录下构建出可用于生产环境的产物。
 
 可以通过修改配置 [`output.distPath`](/docs/configure/app/output/dist-path) 指定产物的输出目录。
 

package/zh/apis/app/commands/index.md

@@ -4,7 +4,7 @@ type: ref
 
 # 命令
 
-本节涵盖了使用应用工程的所有命令。
+本节涵盖了所有命令。
 
 
 

package/zh/apis/app/commands/lint.md

@@ -13,7 +13,7 @@ Options:
   -h, --help  display help for command
 ```
 
-运行 `ESLint` 检查代码语法情况， 通长情况下，我们只需要在 `git commit` 阶段通过 `lint-staged` 检查本次提交修改的部分代码。
+运行 `ESLint` 检查代码语法情况。通常情况下，我们只需要在 `git commit` 阶段通过 `lint-staged` 检查本次提交修改的部分代码。
 
 * `--no-fix` 参数设置后可以关闭自动修复 lint 错误代码的能力。