docs: update descriptions about cjs and esm

Author: meteorlxy

docs/advanced/architecture.md

@@ -11,8 +11,8 @@ The above figure shows a brief overview of the VuePress architecture:
 
 As a developer, you must be aware of that VuePress has two main parts: **Node App** and **Client App**, which is important when developing plugins and themes:
 
-- The entry file of a plugin or a theme will be loaded in Node App. So you need to use CommonJS format for them.
-- Client files will be loaded in Client App, which will be handled by bundler. For example, layouts, components, app setup files, app enhance files, etc. You'd better use ESM format for them.
+- The entry file of a plugin or a theme will be loaded in Node App.
+- Client files will be loaded in Client App, which will be handled by bundler. For example, layouts, components, app setup files, app enhance files, etc.
 
 ## Core Process and Hooks
 

docs/advanced/plugin.md

@@ -15,7 +15,7 @@ const fooPlugin = {
 }
 ```
 
-A plugin could also be a function that receives the [app instace](../reference/node-api.md#app) as the param and returns a *Plugin Object*, which is called a *Plugin Function*:
+A plugin could also be a function that receives the [app instance](../reference/node-api.md#app) as the param and returns a *Plugin Object*, which is called a *Plugin Function*:
 
 ```ts
 const barPlugin = (app) => {

docs/guide/configuration.md

@@ -73,7 +73,7 @@ Similarly, we also have a convention for client config file paths (in order of p
   - `.vuepress/client.js`
   - `.vuepress/client.mjs`
 
-Notice that the client config file should be in ESM format:
+A basic client config file looks like this:
 
 ```ts
 import { defineClientConfig } from '@vuepress/client'

docs/reference/bundler/vite.md

@@ -41,29 +41,3 @@ export default defineUserConfig({
 
 - Also see:
   - [Vite > Plugins > Official Plugins](https://vitejs.dev/plugins/#vitejs-plugin-vue)
-
-## FAQ
-
-### SSR Externals Issue
-
-When you are importing a third-party library (called `foo-lib`), a common error your might meet in build is:
-
-```sh
-Error [ERR_REQUIRE_ESM]: Must use import to load ES Module: /path/to/foo-lib
-```
-
-To get rid of it, you need to set `ssr.noExternal` option:
-
-```ts
-export default defineUserConfig({
-  bundler: viteBundler({
-    viteOptions: {
-      ssr: {
-        noExternal: ['foo-lib'],
-      },
-    },
-  }),
-})
-```
-
-VuePress is using Vite server-side rendering (SSR) to pre-render markdown to HTML files. Although it's quite usable and work well with VuePress, it's still marked as experimental and might have some issues. To fully understand what the above error is, reading [Vite SSR Externals Guide](https://vitejs.dev/guide/ssr.html#ssr-externals) would be helpful.

docs/zh/advanced/architecture.md

@@ -11,8 +11,8 @@
 
 作为开发者，你必须要意识到 VuePress 分为两个主要部分： **Node App** 和 **Client App** ，这一点对于开发插件和主题来说都十分重要。
 
-- 插件或者主题的入口文件会在 Node App 中被加载，因此它们需要使用 CommonJS 格式。
-- 客户端文件会在 Client App 中被加载，也就是会被 Bundler 处理。比如布局、组件、App Setup 文件、App Enhance 文件等。它们最好使用 ESM 格式。
+- 插件或者主题的入口文件会在 Node App 中被加载。
+- 客户端文件会在 Client App 中被加载，也就是会被 Bundler 处理。比如布局、组件、App Setup 文件、App Enhance 文件等。
 
 ## 核心流程与 Hooks
 

docs/zh/guide/configuration.md

@@ -76,7 +76,7 @@ export default defineUserConfig({
   - `.vuepress/client.js`
   - `.vuepress/client.mjs`
 
-需要注意的是，客户端配置文件需要使用 ESM 格式：
+一个基础的客户端配置文件是这样的：
 
 ```ts
 import { defineClientConfig } from '@vuepress/client'

docs/zh/reference/bundler/vite.md

@@ -41,29 +41,3 @@ export default defineUserConfig({
 
 - 参考：
   - [Vite > 插件 > 官方插件](https://cn.vitejs.dev/plugins/#vitejsplugin-vue)
-
-## 常见问题
-
-### SSR Externals 问题
-
-当你引入一个第三方库（如 `foo-lib`）时，你可能会在构建时遇到一个常见的错误：
-
-```sh
-Error [ERR_REQUIRE_ESM]: Must use import to load ES Module: /path/to/foo-lib
-```
-
-此时，你需要设置 `ssr.noExternal` 配置项来解决它：
-
-```ts
-export default defineUserConfig({
-  bundler: viteBundler({
-    viteOptions: {
-      ssr: {
-        noExternal: ['foo-lib'],
-      },
-    },
-  }),
-})
-```
-
-VuePress 使用 Vite 服务端渲染 (SSR) 来将 Markdown 预渲染成 HTML 文件。尽管它可以在 VuePress 中正常使用，但该功能仍然被标记为实验性能力，因此可能会有一些小问题。想要完全理解上面的报错原因，你可以去了解一下 [Vite SSR Externals 文档](https://cn.vitejs.dev/guide/ssr.html#ssr-externals) 。