Skip to content

Commit

Permalink
docs: polish README (#3262)
Browse files Browse the repository at this point in the history
  • Loading branch information
chenjiahan authored Aug 22, 2024
1 parent 06c2aaf commit 8f0e61a
Show file tree
Hide file tree
Showing 7 changed files with 23 additions and 23 deletions.
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ You can think of Rsbuild as a modernized version of Create React App or Vue CLI,
Rsbuild shares many similarities with Vite, as they are both aim to improve the frontend development experience. The main differences are:

- **Ecosystem compatibility**: Rsbuild is compatible with most webpack plugins and all Rspack plugins, while Vite is compatible with Rollup plugins. If you're currently using more plugins and loaders from the webpack ecosystem, migrating to Rsbuild would be relatively easy.
- **Production consistency**: Rsbuild uses Rspack for bundling during both the development and production builds, thus ensuring a high level of consistency between the development and production outputs. This is also one of the goals Vite aims to achieve with [Rolldown](https://rolldown.rs/).
- **Production consistency**: Rsbuild uses Rspack for bundling during both the development and production builds, thus ensuring a high level of consistency between the development and production outputs. This is also one of the goals Vite aims to achieve with Rolldown.
- **Module Federation**: The Rsbuild team works closely with the [Module Federation](https://rsbuild.dev/guide/advanced/module-federation) development team, providing first-class support for Module Federation to help you develop large web applications with micro frontend architecture.

## 🚀 Performance
Expand All @@ -58,11 +58,11 @@ Rsbuild has the following features:

- **Stable Artifacts**: Rsbuild is designed with a strong focus on the stability of build artifacts. It ensures high consistency between artifacts in the development and production builds, and automatically completes syntax downgrading and polyfill injection. Rsbuild also provides plugins for type checking and artifact syntax validation to prevent quality and compatibility issues in production code.

- **Framework Agnostic**: Rsbuild is not coupled with any front-end UI framework. It supports frameworks like React, Vue 3, Vue 2, Svelte, Solid, and Lit through plugins, and plans to support more UI frameworks from the community in the future.
- **Framework Agnostic**: Rsbuild is not coupled with any front-end UI framework. It supports frameworks like React, Vue, Svelte, Solid, and Preact through plugins, and plans to support more UI frameworks from the community in the future.

## 🎯 Position
## 🎯 Ecosystem

In addition to being used as a build tool, Rsbuild also provides universal build capabilities for higher-level solutions, such as [Rspress](https://github.com/web-infra-dev/rspress) and [Rslib](https://github.com/web-infra-dev/rslib), allowing them to focus on the development of their own domain specific capabilities.
In addition to being used as a build tool, Rsbuild also provides universal build capabilities for higher-level frameworks and tools, such as [Rspress](https://github.com/web-infra-dev/rspress) and [Rslib](https://github.com/web-infra-dev/rslib), allowing them to focus on the development of their own domain specific capabilities.

The following diagram illustrates the relationship between Rsbuild and other tools in the ecosystem:

Expand Down
6 changes: 3 additions & 3 deletions README.pt-BR.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ Você pode imaginar o Rsbuild como uma versão moderna do Create React App ou Vu
Rsbuild compartilha muitas similaridades com Vite, assim como ambos miram em melhorar a experiência do desenvolvimento frontend. As principais diferenças são:

- **Compatibilidade do ecossistema**: Rsbuild é compatível com a maioria dos plug-ins para webpack e todos os plug-ins do Rspack, enquanto Vite é compatível com plug-ins do Rollup. Se você estiver usando mais plug-ins e carregadores do ecossistema do Webpack, a migração para o Rsbuild será relativamente fácil.
- **Consistência em produção**: Rsbuild usa o Rspack para empacotamento durante as compilações de desenvolvimento e produção, garantindo assim um alto nível de consistência entre os resultados de desenvolvimento e produção. Esse também é um dos objetivos que a Vite pretende alcançar com o [Rolldown](https://rolldown.rs/).
- **Consistência em produção**: Rsbuild usa o Rspack para empacotamento durante as compilações de desenvolvimento e produção, garantindo assim um alto nível de consistência entre os resultados de desenvolvimento e produção. Esse também é um dos objetivos que a Vite pretende alcançar com o Rolldown.
- **Module Federation**: O time do Rsbuild trabalha próximo com o time de [Module Federation](https://rsbuild.dev/guide/advanced/module-federation), fornecendo suporte de primeira classe para o Module Federation para ajudá-lo a desenvolver grandes aplicativos da Web com arquitetura de micro frontend.

## 🚀 Desempenho
Expand All @@ -58,9 +58,9 @@ O Rsbuild tem os seguintes recursos:

- **Artefatos estáveis**: O Rsbuild foi projetado com um grande foco na estabilidade dos artefatos de compilação. Ele garante alta consistência entre os artefatos nas compilações de desenvolvimento e produção e conclui automaticamente o downgrade de sintaxe e a injeção de polyfill. O Rsbuild também fornece plug-ins para verificação de tipos e validação de sintaxe de artefatos para evitar problemas de qualidade e compatibilidade no código de produção.

- **Framework Agnóstico**: Rsbuild não está acoplado a nenhuma estrutura de interface do usuário de frontend. Ele oferece suporte a estruturas como React, Vue 3, Vue 2, Svelte, Solid e Lit por meio de plug-ins, e planeja oferecer suporte a mais estruturas de IU da comunidade no futuro.
- **Framework Agnóstico**: Rsbuild não está acoplado a nenhuma estrutura de interface do usuário de frontend. Ele oferece suporte a estruturas como React, Vue, Svelte, Solid e Preact por meio de plug-ins, e planeja oferecer suporte a mais estruturas de IU da comunidade no futuro.

## 🎯 Função
## 🎯 Ecossistema

Além de ser usado como uma ferramenta de compilação, o Rsbuild também oferece recursos de compilação universal para soluções de nível superior, como [Rspress](https://github.com/web-infra-dev/rspress) e [Rslib](https://github.com/web-infra-dev/rslib), permitindo que eles se concentrem no desenvolvimento de seus próprios recursos específicos de domínio.

Expand Down
10 changes: 5 additions & 5 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Rsbuild 提供 [丰富的构建功能](https://rsbuild.dev/zh/guide/start/featur

## 💡 对比其他工具

Rsbuild 是与 [Vite](https://vitejs.dev/)[Create React App](https://github.com/facebook/create-react-app)[Vue CLI](https://github.com/vuejs/vue-cli) 处于同一层级的构建工具,它们都默认包含了开发服务器、命令行工具和合理的构建配置,以此来提供开箱即用的体验。
Rsbuild 是与 [Vite](https://vitejs.dev/)[Create React App](https://github.com/facebook/create-react-app)[Vue CLI](https://github.com/vuejs/vue-cli) 相似的构建工具,它们都默认包含了开发服务器、命令行工具和合理的构建配置,以此来提供开箱即用的体验。

### CRA / Vue CLI

Expand All @@ -35,7 +35,7 @@ Rsbuild 是与 [Vite](https://vitejs.dev/)、[Create React App](https://github.c
Rsbuild 与 Vite 有许多相似之处,它们皆致力于提升前端的开发体验。其主要区别在于:

- **生态兼容性**:Rsbuild 兼容大部分的 webpack 插件和所有 Rspack 插件,而 Vite 则是兼容 Rollup 插件。如果你目前更多地使用了 webpack 生态的插件和 loaders,那么迁移到 Rsbuild 是相对容易的。
- **生产一致性**:Rsbuild 在开发阶段和生产构建均使用 Rspack 进行打包,因此开发和生产构建的产物具备较强的一致性,这也是 Vite 通过 [Rolldown](https://rolldown.rs/) 想要实现的目标之一。
- **生产一致性**:Rsbuild 在开发阶段和生产构建均使用 Rspack 进行打包,因此开发和生产构建的产物具备较强的一致性,这也是 Vite 通过 Rolldown 想要实现的目标之一。
- **模块联邦**:Rsbuild 团队与 [Module Federation](https://rsbuild.dev/zh/guide/advanced/module-federation) 的开发团队密切合作,并为 Module Federation 提供一流的支持,帮助你开发微前端架构的大型 Web 应用。

## 🚀 性能
Expand All @@ -58,11 +58,11 @@ Rsbuild 具备以下特性:

- **产物稳定**:Rsbuild 设计时充分考虑了构建产物的稳定性,它的开发和生产构建产物具备较强的一致性,并自动完成语法降级和 polyfill 注入。Rsbuild 也提供插件来进行 TypeScript 类型检查和产物语法检查,以避免线上代码的质量问题和兼容性问题。

- **框架无关**:Rsbuild 不与前端 UI 框架耦合,并通过插件来支持 React、Vue 3、Vue 2、Svelte、Solid、Lit 等框架,未来也计划支持社区中更多的 UI 框架。
- **框架无关**:Rsbuild 不与前端 UI 框架耦合,并通过插件来支持 React、VueSvelte、Solid、Preact 等框架,未来也计划支持社区中更多的 UI 框架。

## 🎯 定位
## 🎯 生态

除了作为一个构建工具使用,Rsbuild 也为上层的解决方案提供通用的构建能力,比如 [Rspress](https://github.com/web-infra-dev/rspress)[Rslib](https://github.com/web-infra-dev/rslib)使他们能够专注于开发自己领域特定的能力
除了作为一个构建工具使用,Rsbuild 也为上层的框架和工具提供通用的构建能力,比如 [Rspress](https://github.com/web-infra-dev/rspress)[Rslib](https://github.com/web-infra-dev/rslib)使它们能够专注于开发自己领域特定的能力

下图说明了 Rsbuild 与生态中其他工具之间的关系:

Expand Down
2 changes: 1 addition & 1 deletion website/docs/en/community/releases/v0-1.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ Rsbuild has the following features:

- **Stable Artifacts**: Rsbuild is designed with a strong focus on the stability of build artifacts. It ensures high consistency between artifacts in the development and production builds, and automatically completes syntax downgrading and polyfill injection. Rsbuild also provides plugins for type checking and artifact syntax validation to prevent quality and compatibility issues in production code.

- **Framework Agnostic**: Rsbuild is not coupled with any front-end UI framework. It supports frameworks like React, Vue 3, Vue 2, Svelte, Solid and Lit through plugins, and plans to support more UI frameworks from the community in the future.
- **Framework Agnostic**: Rsbuild is not coupled with any front-end UI framework. It supports frameworks like React, Vue, Svelte, Solid and Preact through plugins, and plans to support more UI frameworks from the community in the future.

### 💡 Next Step

Expand Down
8 changes: 4 additions & 4 deletions website/docs/en/guide/start/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ You can think of Rsbuild as a modernized version of Create React App or Vue CLI,
Rsbuild shares many similarities with Vite, as they are both aim to improve the frontend development experience. The main differences are:

- **Ecosystem compatibility**: Rsbuild is compatible with most webpack plugins and all Rspack plugins, while Vite is compatible with Rollup plugins. If you're currently using more plugins and loaders from the webpack ecosystem, migrating to Rsbuild would be relatively easy.
- **Production consistency**: Rsbuild uses Rspack for bundling during both the development and production builds, thus ensuring a high level of consistency between the development and production outputs. This is also one of the goals Vite aims to achieve with [Rolldown](https://rolldown.rs/).
- **Production consistency**: Rsbuild uses Rspack for bundling during both the development and production builds, thus ensuring a high level of consistency between the development and production outputs. This is also one of the goals Vite aims to achieve with Rolldown.
- **Module Federation**: The Rsbuild team works closely with the [Module Federation](/guide/advanced/module-federation) development team, providing first-class support for Module Federation to help you develop large web applications with micro frontend architecture.

## 🚀 Performance
Expand All @@ -46,11 +46,11 @@ Rsbuild has the following features:

- **Stable Artifacts**: Rsbuild is designed with a strong focus on the stability of build artifacts. It ensures high consistency between artifacts in the development and production builds, and automatically completes syntax downgrading and polyfill injection. Rsbuild also provides plugins for type checking and artifact syntax validation to prevent quality and compatibility issues in production code.

- **Framework Agnostic**: Rsbuild is not coupled with any front-end UI framework. It supports frameworks like React, Vue 3, Vue 2, Svelte, Solid, and Lit through plugins, and plans to support more UI frameworks from the community in the future.
- **Framework Agnostic**: Rsbuild is not coupled with any front-end UI framework. It supports frameworks like React, Vue, Svelte, Solid, and Preact through plugins, and plans to support more UI frameworks from the community in the future.

## 🎯 Position
## 🎯 Ecosystem

In addition to being used as a build tool, Rsbuild also provides universal build capabilities for higher-level solutions, such as [Rspress](https://github.com/web-infra-dev/rspress) and [Rslib](https://github.com/web-infra-dev/rslib), allowing them to focus on the development of their own domain specific capabilities.
In addition to being used as a build tool, Rsbuild also provides universal build capabilities for higher-level frameworks and tools, such as [Rspress](https://github.com/web-infra-dev/rspress) and [Rslib](https://github.com/web-infra-dev/rslib), allowing them to focus on the development of their own domain specific capabilities.

The following diagram illustrates the relationship between Rsbuild and other tools in the ecosystem:

Expand Down
2 changes: 1 addition & 1 deletion website/docs/zh/community/releases/v0-1.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ Rsbuild 具备以下特性:

- **产物稳定**:Rsbuild 设计时充分考虑了构建产物的稳定性,它的开发和生产构建产物具备较强的一致性,并自动完成语法降级和 polyfill 注入。Rsbuild 也提供插件来进行 TypeScript 类型检查和产物语法检查,以避免线上代码的质量问题和兼容性问题。

- **框架无关**:Rsbuild 不与前端 UI 框架耦合,并通过插件来支持 React、Vue 3、Vue 2、Svelte、Solid、Lit 等框架,未来也计划支持社区中更多的 UI 框架。
- **框架无关**:Rsbuild 不与前端 UI 框架耦合,并通过插件来支持 React、VueSvelte、Solid、Preact 等框架,未来也计划支持社区中更多的 UI 框架。

### 💡 下一步

Expand Down
10 changes: 5 additions & 5 deletions website/docs/zh/guide/start/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Rsbuild 提供 [丰富的构建功能](/guide/start/features),包括编译 Typ

## 💡 对比其他工具

Rsbuild 是与 [Vite](https://vitejs.dev/)[Create React App](https://github.com/facebook/create-react-app)[Vue CLI](https://github.com/vuejs/vue-cli) 处于同一层级的构建工具,它们都默认包含了开发服务器、命令行工具和合理的构建配置,以此来提供开箱即用的体验。
Rsbuild 是与 [Vite](https://vitejs.dev/)[Create React App](https://github.com/facebook/create-react-app)[Vue CLI](https://github.com/vuejs/vue-cli) 相似的构建工具,它们都默认包含了开发服务器、命令行工具和合理的构建配置,以此来提供开箱即用的体验。

### CRA / Vue CLI

Expand All @@ -21,7 +21,7 @@ Rsbuild 是与 [Vite](https://vitejs.dev/)、[Create React App](https://github.c
Rsbuild 与 Vite 有许多相似之处,它们皆致力于提升前端的开发体验。其主要区别在于:

- **生态兼容性**:Rsbuild 兼容大部分的 webpack 插件和所有 Rspack 插件,而 Vite 则是兼容 Rollup 插件。如果你目前更多地使用了 webpack 生态的插件和 loaders,那么迁移到 Rsbuild 是相对容易的。
- **生产一致性**:Rsbuild 在开发阶段和生产构建均使用 Rspack 进行打包,因此开发和生产构建的产物具备较强的一致性,这也是 Vite 通过 [Rolldown](https://rolldown.rs/) 想要实现的目标之一。
- **生产一致性**:Rsbuild 在开发阶段和生产构建均使用 Rspack 进行打包,因此开发和生产构建的产物具备较强的一致性,这也是 Vite 通过 Rolldown 想要实现的目标之一。
- **模块联邦**:Rsbuild 团队与 [Module Federation](/guide/advanced/module-federation) 的开发团队密切合作,并为 Module Federation 提供一流的支持,帮助你开发微前端架构的大型 Web 应用。

## 🚀 性能
Expand All @@ -46,11 +46,11 @@ Rsbuild 具备以下特性:

- **产物稳定**:Rsbuild 设计时充分考虑了构建产物的稳定性,它的开发和生产构建产物具备较强的一致性,并自动完成语法降级和 polyfill 注入。Rsbuild 也提供插件来进行类型检查和产物语法检查,以避免线上代码的质量问题和兼容性问题。

- **框架无关**:Rsbuild 不与前端 UI 框架耦合,并通过插件来支持 React、Vue 3、Vue 2、Svelte、Solid、Lit 等框架,未来也计划支持社区中更多的 UI 框架。
- **框架无关**:Rsbuild 不与前端 UI 框架耦合,并通过插件来支持 React、VueSvelte、Solid、Preact 等框架,未来也计划支持社区中更多的 UI 框架。

## 🎯 定位
## 🎯 生态

除了作为一个构建工具使用,Rsbuild 也为上层的解决方案提供通用的构建能力,比如 [Rspress](https://github.com/web-infra-dev/rspress)[Rslib](https://github.com/web-infra-dev/rslib)使他们能够专注于开发自己领域特定的能力
除了作为一个构建工具使用,Rsbuild 也为上层的框架和工具提供通用的构建能力,比如 [Rspress](https://github.com/web-infra-dev/rspress)[Rslib](https://github.com/web-infra-dev/rslib)使它们能够专注于开发自己领域特定的能力

下图说明了 Rsbuild 与生态中其他工具之间的关系:

Expand Down

0 comments on commit 8f0e61a

Please sign in to comment.