From 615e4b55385ac35c424496339fa5ce7125d43dfa Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 02:08:13 -0500
Subject: [PATCH 01/25] Minor SPAG edits

---
 docs/en/guide/asset-handling.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/en/guide/asset-handling.md b/docs/en/guide/asset-handling.md
index eeedc8c02565..01f13b70da84 100644
--- a/docs/en/guide/asset-handling.md
+++ b/docs/en/guide/asset-handling.md
@@ -8,9 +8,9 @@ All Markdown files are compiled into Vue components and processed by [Vite](http
 ![An image](./image.png)
 ```
 
-You can reference static assets in your markdown files, your `*.vue` components in the theme, styles and plain `.css` files either using absolute public paths (based on project root) or relative paths (based on your file system). The latter is similar to the behavior you are used to if you have used Vite, Vue CLI, or webpack's `file-loader`.
+You can reference static assets in your markdown files, your `*.vue` components in the theme, styles, and plain `.css` files either using absolute public paths (based on project root) or relative paths (based on your file system). The latter is similar to the behavior you are used to if you have used Vite, Vue CLI, or webpack's `file-loader`.
 
-Common image, media, and font filetypes are detected and included as assets automatically.
+Common image, media, and font file types are detected and included as assets automatically.
 
 ::: tip Linked files are not treated as assets
 PDFs or other documents referenced by links within markdown files are not automatically treated as assets. To make linked files accessible, you must manually place them within the [`public`](#the-public-directory) directory of your project.
@@ -24,11 +24,11 @@ All **static** path references, including absolute paths, should be based on you
 
 Sometimes you may need to provide static assets that are not directly referenced in any of your Markdown or theme components, or you may want to serve certain files with the original filename. Examples of such files include `robots.txt`, favicons, and PWA icons.
 
-You can place these files in the `public` directory under the [source directory](./routing#source-directory). For example, if your project root is `./docs` and using default source directory location, then your public directory will be `./docs/public`.
+You can place these files in the `public` directory under the [source directory](./routing#source-directory). For example, if your project root is `./docs` and using the default source directory location, then your public directory will be `./docs/public`.
 
 Assets placed in `public` will be copied to the root of the output directory as-is.
 
-Note that you should reference files placed in `public` using root absolute path - for example, `public/icon.png` should always be referenced in source code as `/icon.png`.
+Note that you should reference files placed in `public` using the root absolute path - for example, `public/icon.png` should always be referenced in source code as `/icon.png`.
 
 ## Base URL
 
@@ -48,7 +48,7 @@ However, if you are authoring a theme component that links to assets dynamically
 <img :src="theme.logoPath" />
 ```
 
-In this case it is recommended to wrap the path with the [`withBase` helper](../reference/runtime-api#withbase) provided by VitePress:
+In this case, it is recommended to wrap the path with the [`withBase` helper](../reference/runtime-api#withbase) provided by VitePress:
 
 ```vue
 <script setup>

From b956b66599e5ed6b55dc7a1d06d15efada8c67b8 Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 02:09:55 -0500
Subject: [PATCH 02/25] Update cms.md

---
 docs/en/guide/cms.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/en/guide/cms.md b/docs/en/guide/cms.md
index 8694cf0a5114..d4f1b01dccf5 100644
--- a/docs/en/guide/cms.md
+++ b/docs/en/guide/cms.md
@@ -10,7 +10,7 @@ Connecting VitePress to a CMS will largely revolve around [Dynamic Routes](./rou
 
 Since each CMS will work differently, here we can only provide a generic workflow that you will need to adapt to your specific scenario.
 
-1. If your CMS requires authentication, create an `.env` file to store your API tokens and load it so:
+1. If your CMS requires authentication, create a `.env` file to store your API tokens and load it so:
 
     ```js
     // posts/[id].paths.js
@@ -41,7 +41,7 @@ Since each CMS will work differently, here we can only provide a generic workflo
     }
     ```
 
-3. Render the content in the page:
+3. Render the content on the page:
 
     ```md
     # {{ $params.title }}

From 1b14484238d34901785b415b41eb678fbac569be Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 02:11:22 -0500
Subject: [PATCH 03/25] Update custom-theme.md

---
 docs/en/guide/custom-theme.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/en/guide/custom-theme.md b/docs/en/guide/custom-theme.md
index 1d168ce9b508..1c37690d8937 100644
--- a/docs/en/guide/custom-theme.md
+++ b/docs/en/guide/custom-theme.md
@@ -15,7 +15,7 @@ You can enable a custom theme by creating a `.vitepress/theme/index.js` or `.vit
 └─ package.json
 ```
 
-VitePress will always use the custom theme instead of the default theme when it detects presence of a theme entry file. You can, however, [extend the default theme](./extending-default-theme) to perform advanced customizations on top of it.
+VitePress will always use the custom theme instead of the default theme when it detects the presence of a theme entry file. You can, however, [extend the default theme](./extending-default-theme) to perform advanced customizations on top of it.
 
 ## Theme Interface
 
@@ -100,7 +100,7 @@ const { page } = useData()
 </template>
 ```
 
-The [`useData()`](../reference/runtime-api#usedata) helper provides us with all the runtime data we need to conditionally render different layouts. One of the other data we can access is the current page's frontmatter. We can leverage this to allow the end user to control the layout in each page. For example, the user can indicate the page should use a special home page layout with:
+The [`useData()`](../reference/runtime-api#usedata) helper provides us with all the runtime data we need to conditionally render different layouts. One of the other data we can access is the current page's frontmatter. We can leverage this to allow the end user to control the layout of each page. For example, the user can indicate the page should use a special home page layout with:
 
 ```md
 ---
@@ -150,7 +150,7 @@ const { page, frontmatter } = useData()
 </template>
 ```
 
-Consult the [Runtime API Reference](../reference/runtime-api) for everything available in theme components. In addition, you can leverage [Build-Time Data Loading](./data-loading) to generate data-driven layout - for example, a page that lists all blog posts in the current project.
+Consult the [Runtime API Reference](../reference/runtime-api) for everything available in theme components. In addition, you can leverage [Build-Time Data Loading](./data-loading) to generate a data-driven layout - for example, a page that lists all blog posts in the current project.
 
 ## Distributing a Custom Theme
 
@@ -193,7 +193,7 @@ export default {
 }
 ```
 
-If the theme requires special VitePress config, you will need to also extend it in your own config:
+If the theme requires a special VitePress config, you will need to also extend it in your own config:
 
 ```ts
 // .vitepress/config.ts

From f30c4a2b2b517fd10dabc2e80a0d27977d79a478 Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 02:13:29 -0500
Subject: [PATCH 04/25] Update data-loading.md

---
 docs/en/guide/data-loading.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/en/guide/data-loading.md b/docs/en/guide/data-loading.md
index 3005f642bc15..148f1be77da8 100644
--- a/docs/en/guide/data-loading.md
+++ b/docs/en/guide/data-loading.md
@@ -2,7 +2,7 @@
 
 VitePress provides a feature called **data loaders** that allows you to load arbitrary data and import it from pages or components. The data loading is executed **only at build time**: the resulting data will be serialized as JSON in the final JavaScript bundle.
 
-Data loaders can be used to fetch remote data, or generate metadata based on local files. For example, you can use data loaders to parse all your local API pages and automatically generate an index of all API entries.
+Data loaders can be used to fetch remote data to or generate metadata based on local files. For example, you can use data loaders to parse all your local API pages and automatically generate an index of all API entries.
 
 ## Basic Usage
 
@@ -82,7 +82,7 @@ export default {
 
 ## `createContentLoader`
 
-When building a content focused site, we often need to create an "archive" or "index" page: a page where we list all available entries in our content collection, for example blog posts or API pages. We **can** implement this directly with the data loader API, but since this is such a common use case, VitePress also provides a `createContentLoader` helper to simplify this:
+When building a content-focused site, we often need to create an "archive" or "index" page: a page where we list all available entries in our content collection, for example, blog posts or API pages. We **can** implement this directly with the data loader API, but since this is such a common use case, VitePress also provides a `createContentLoader` helper to simplify this:
 
 ```js
 // posts.data.js
@@ -91,7 +91,7 @@ import { createContentLoader } from 'vitepress'
 export default createContentLoader('posts/*.md', /* options */)
 ```
 
-The helper takes a glob pattern relative to the [source directory](./routing#source-directory), and returns a `{ watch, load }` data loader object that can be used as the default export in a data loader file. It also implements caching based on file modified timestamps to improve dev performance.
+The helper takes a glob pattern relative to the [source directory](./routing#source-directory), and returns a `{ watch, load }` data loader object that can be used as the default export in a data loader file. It also implements caching based on file modification timestamps to improve dev performance.
 
 Note the loader only works with Markdown files - matched non-Markdown files will be skipped.
 
@@ -113,7 +113,7 @@ interface ContentData {
 }
 ```
 
-By default, only `url` and `frontmatter` are provided. This is because the loaded data will be inlined as JSON in the client bundle, so we need to be cautious about its size. Here's an example using the data to build a minimal blog index page:
+By default, only `url` and `frontmatter` are provided. This is because the loaded data will be inlined as JSON in the client bundle, so we need to be cautious about its size. Here's an example which uses the data to build a minimal blog index page:
 
 ```vue
 <script setup>

From 7f5c21651eee6cb0c75e45de5002093e4dadf658 Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 02:17:27 -0500
Subject: [PATCH 05/25] Update deploy.md

---
 docs/en/guide/deploy.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/en/guide/deploy.md b/docs/en/guide/deploy.md
index 852fb868e02f..932e1d438ce9 100644
--- a/docs/en/guide/deploy.md
+++ b/docs/en/guide/deploy.md
@@ -57,7 +57,7 @@ By default, we assume the site is going to be deployed at the root path of a dom
 
 If you have control over the HTTP headers on your production server, you can configure `cache-control` headers to achieve better performance on repeated visits.
 
-The production build uses hashed file names for static assets (JavaScript, CSS and other imported assets not in `public`). If you inspect the production preview using your browser devtools' network tab, you will see files like `app.4f283b18.js`.
+The production build uses hashed file names for static assets (JavaScript, CSS, and other imported assets not in `public`). If you inspect the production preview using your browser developer tools' network tab, you will see files like `app.4f283b18.js`.
 
 This `4f283b18` hash is generated from the content of this file. The same hashed URL is guaranteed to serve the same file content - if the contents change, the URLs change too. This means you can safely use the strongest cache headers for these files. All such files will be placed under `assets/` in the output directory, so you can configure the following header for them:
 
@@ -114,7 +114,7 @@ Set up a new project and change these settings using your dashboard:
 - **Node Version:** `18` (or above)
 
 ::: warning
-Don't enable options like _Auto Minify_ for HTML code. It will remove comments from output which have meaning to Vue. You may see hydration mismatch errors if they get removed.
+Don't enable options like _Auto Minify_ for HTML code. It will remove comments, which have meaning to Vue, from output. You may see hydration mismatch errors if they get removed.
 :::
 
 ### GitHub Pages
@@ -198,7 +198,7 @@ Don't enable options like _Auto Minify_ for HTML code. It will remove comments f
 
 ### GitLab Pages
 
-1. Set `outDir` in VitePress config to `../public`. Configure `base` option to `'/<repository>/'` if you want to deploy to `https://<username>.gitlab.io/<repository>/`. You don't need `base` if you're deploying to custom domain, user or group pages, or have "Use unique domain" setting enabled in GitLab.
+1. Set `outDir` in VitePress config to `../public`. Configure `base` option to `'/<repository>/'` if you want to deploy to `https://<username>.gitlab.io/<repository>/`. You don't need `base` if you're deploying to a custom domain, user/group pages, or have the "Use unique domain" setting enabled in GitLab.
 
 2. Create a file named `.gitlab-ci.yml` in the root of your project with the content below. This will build and deploy your site whenever you make changes to your content:
 
@@ -270,7 +270,7 @@ Don't enable options like _Auto Minify_ for HTML code. It will remove comments f
 
 ### Heroku
 
-1. Follow documentation and guide given in [`heroku-buildpack-static`](https://elements.heroku.com/buildpacks/heroku/heroku-buildpack-static).
+1. Follow the documentation and guide avaliable at [`heroku-buildpack-static`](https://elements.heroku.com/buildpacks/heroku/heroku-buildpack-static).
 
 2. Create a file called `static.json` in the root of your project with the below content:
 
@@ -282,7 +282,7 @@ Don't enable options like _Auto Minify_ for HTML code. It will remove comments f
 
 ### Edgio
 
-Refer [Creating and Deploying a VitePress App To Edgio](https://docs.edg.io/guides/vitepress).
+Refer to [Creating and Deploying a VitePress App To Edgio](https://docs.edg.io/guides/vitepress).
 
 ### Kinsta Static Site Hosting
 
@@ -294,7 +294,7 @@ You can deploy your VitePress project to [Stormkit](https://www.stormkit.io) by
 
 ### Nginx
 
-Here is a example of an Nginx server block configuration. This setup includes gzip compression for common text-based assets, rules for serving your VitePress site's static files with proper caching headers as well as handling `cleanUrls: true`.
+Here is an example of an Nginx server block configuration. This setup includes gzip compression for common text-based assets, rules for serving your VitePress site's static files with proper caching headers, as well as handling `cleanUrls: true`.
 
 ```nginx
 server {

From ad2053949a6666affbe83cc4109f5563d288401d Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 02:19:30 -0500
Subject: [PATCH 06/25] Update extending-default-theme.md

---
 docs/en/guide/extending-default-theme.md | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/docs/en/guide/extending-default-theme.md b/docs/en/guide/extending-default-theme.md
index 71f369f95c3c..70bc0eae93f0 100644
--- a/docs/en/guide/extending-default-theme.md
+++ b/docs/en/guide/extending-default-theme.md
@@ -4,12 +4,12 @@ outline: deep
 
 # Extending the Default Theme
 
-VitePress' default theme is optimized for documentation, and can be customized. Consult the [Default Theme Config Overview](../reference/default-theme-config) for a comprehensive list of options.
+VitePress' default theme is optimized for documentation and can be customized. Consult the [Default Theme Config Overview](../reference/default-theme-config) for a comprehensive list of options.
 
 However, there are a number of cases where configuration alone won't be enough. For example:
 
 1. You need to tweak the CSS styling;
-2. You need to modify the Vue app instance, for example to register global components;
+2. You need to modify the Vue app instance, for example, to register global components;
 3. You need to inject custom content into the theme via layout slots.
 
 These advanced customizations will require using a custom theme that "extends" the default theme.
@@ -20,7 +20,7 @@ Before proceeding, make sure to first read [Using a Custom Theme](./custom-theme
 
 ## Customizing CSS
 
-The default theme CSS is customizable by overriding root level CSS variables:
+The default theme CSS is customizable by overriding root-level CSS variables:
 
 ```js
 // .vitepress/theme/index.js
@@ -42,7 +42,7 @@ See [default theme CSS variables](https://github.com/vuejs/vitepress/blob/main/s
 
 ## Using Different Fonts
 
-VitePress uses [Inter](https://rsms.me/inter/) as the default font, and will include the fonts in the build output. The font is also auto preloaded in production. However, this may not be desirable if you want to use a different main font.
+VitePress uses [Inter](https://rsms.me/inter/) as the default font, and will include the fonts in the build output. The font is also automatically preloaded in production. However, this may not be desirable if you want to use a different main font.
 
 To avoid including Inter in the build output, import the theme from `vitepress/theme-without-fonts` instead:
 
@@ -66,7 +66,7 @@ export default DefaultTheme
 If you are using optional components like the [Team Page](../reference/default-theme-team-page) components, make sure to also import them from `vitepress/theme-without-fonts`!
 :::
 
-If your font is a local file referenced via `@font-face`, it will be processed as an asset and included under `.vitepress/dist/assets` with hashed filename. To preload this file, use the [transformHead](../reference/site-config#transformhead) build hook:
+If your font is a local file referenced via `@font-face`, it will be processed as an asset and included under `.vitepress/dist/assets` with a hashed filename. To preload this file, use the [transformHead](../reference/site-config#transformhead) build hook:
 
 ```js
 // .vitepress/config.js
@@ -123,7 +123,7 @@ export default {
 } satisfies Theme
 ```
 
-Since we are using Vite, you can also leverage Vite's [glob import feature](https://vitejs.dev/guide/features.html#glob-import) to auto register a directory of components.
+Since we are using Vite, you can also leverage Vite's [glob import feature](https://vitejs.dev/guide/features.html#glob-import) to auto-register a directory of components.
 
 ## Layout Slots
 
@@ -159,7 +159,7 @@ const { Layout } = DefaultTheme
 </template>
 ```
 
-Or you could use render function as well.
+Or you could use a render function as well.
 
 ```js
 // .vitepress/theme/index.js
@@ -308,7 +308,7 @@ Result (**warning!**: flashing colors, sudden movements, bright lights):
 
 </details>
 
-Refer [Chrome Docs](https://developer.chrome.com/docs/web-platform/view-transitions/) from more details on view transitions.
+Refer [Chrome Docs](https://developer.chrome.com/docs/web-platform/view-transitions/) for more details on view transitions.
 
 ### On Route Change
 
@@ -338,4 +338,4 @@ export default defineConfig({
 })
 ```
 
-To know the exact name of the component refer [our source code](https://github.com/vuejs/vitepress/tree/main/src/client/theme-default/components). Since the components are internal, there is a slight chance their name is updated between minor releases.
+To know the exact name of the component, please refer to [our source code](https://github.com/vuejs/vitepress/tree/main/src/client/theme-default/components). Since these components are internal, there is a slight chance their names may be updated between minor releases.

From 87577d74e224714e9c4a98e83e3609c372e6af58 Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 03:00:18 -0500
Subject: [PATCH 07/25] Update frontmatter.md

---
 docs/en/guide/frontmatter.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/en/guide/frontmatter.md b/docs/en/guide/frontmatter.md
index c1856ca4ba14..e2efa753e56a 100644
--- a/docs/en/guide/frontmatter.md
+++ b/docs/en/guide/frontmatter.md
@@ -2,7 +2,7 @@
 
 ## Usage
 
-VitePress supports YAML frontmatter in all Markdown files, parsing them with [gray-matter](https://github.com/jonschlinkert/gray-matter). The frontmatter must be at the top of the Markdown file (before any elements including `<script>` tags), and must take the form of valid YAML set between triple-dashed lines. Example:
+VitePress supports YAML frontmatter in all Markdown files, parsing them with [gray-matter](https://github.com/jonschlinkert/gray-matter). The frontmatter must be at the top of the Markdown file (before any elements including `<script>` tags) and must take the form of valid YAML set between triple-dashed lines. Example:
 
 ```md
 ---
@@ -32,7 +32,7 @@ editLink: true
 Guide content
 ```
 
-You can also access current page's frontmatter data in `<script setup>` with the [`useData()`](../reference/runtime-api#usedata) helper.
+You can also access the current page's frontmatter data in `<script setup>` with the [`useData()`](../reference/runtime-api#usedata) helper.
 
 ## Alternative Frontmatter Formats
 

From 49602b8be2b211d35373a441dba92746c1a28db9 Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 03:03:18 -0500
Subject: [PATCH 08/25] Update i18n.md

---
 docs/en/guide/i18n.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/en/guide/i18n.md b/docs/en/guide/i18n.md
index b055c16082b2..92f1f0b9beab 100644
--- a/docs/en/guide/i18n.md
+++ b/docs/en/guide/i18n.md
@@ -51,7 +51,7 @@ interface LocaleSpecificConfig<ThemeConfig = any> {
 
 Refer [`DefaultTheme.Config`](https://github.com/vuejs/vitepress/blob/main/types/default-theme.d.ts) interface for details on customizing the placeholder texts of the default theme. Don't override `themeConfig.algolia` or `themeConfig.carbonAds` at locale-level. Refer [Algolia docs](../reference/default-theme-search#i18n) for using multilingual search.
 
-**Pro tip:** Config file can be stored at `docs/.vitepress/config/index.ts` too. It might help you organize stuff by creating a configuration file per locale and then merge and export them from `index.ts`.
+**Pro tip:** Config file can be stored at `docs/.vitepress/config/index.ts` too. It might help you organize stuff by creating a configuration file per locale and then to merge and export them from `index.ts`.
 
 ## Separate directory for each locale
 
@@ -75,7 +75,7 @@ However, VitePress won't redirect `/` to `/en/` by default. You'll need to confi
 /*  /en/:splat  302
 ```
 
-**Pro tip:** If using the above approach, you can use `nf_lang` cookie to persist user's language choice:
+**Pro tip:** If using the above approach, you can use `nf_lang` cookie to make the user's language choice persistent:
 
 ```ts
 // docs/.vitepress/theme/index.ts

From ab19cde75f3ad3454c1e8fcd75d08c510c6460c3 Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 03:13:17 -0500
Subject: [PATCH 09/25] Update markdown.md

---
 docs/en/guide/markdown.md | 30 +++++++++++++++---------------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/docs/en/guide/markdown.md b/docs/en/guide/markdown.md
index e37631674641..9fe9e5877fac 100644
--- a/docs/en/guide/markdown.md
+++ b/docs/en/guide/markdown.md
@@ -1,6 +1,6 @@
 # Markdown Extensions
 
-VitePress comes with built in Markdown Extensions.
+VitePress comes with built-in Markdown Extensions.
 
 ## Header Anchors
 
@@ -22,7 +22,7 @@ Both internal and external links get special treatment.
 
 ### Internal Links
 
-Internal links are converted to router link for SPA navigation. Also, every `index.md` contained in each sub-directory will automatically be converted to `index.html`, with corresponding URL `/`.
+Internal links are converted to router links for SPA navigation. Also, every `index.md` contained in each sub-directory will automatically be converted to `index.html`, with the corresponding URL `/`.
 
 For example, given the following directory structure:
 
@@ -178,7 +178,7 @@ This is a details block.
 
 ### Custom Title
 
-You may set custom title by appending the text right after the "type" of the container.
+You may set a custom title by appending the text right after the "type" of the container.
 
 **Input**
 
@@ -206,7 +206,7 @@ console.log('Hello, VitePress!')
 ```
 :::
 
-Also, you may set custom titles globally by adding the following content in site config, helpful if not writing in English:
+Also, you may set custom titles globally by adding the following content to your site config, helpful if not writing in English:
 
 ```ts
 // config.ts
@@ -301,7 +301,7 @@ VitePress also supports [GitHub-flavored alerts](https://docs.github.com/en/get-
 
 ## Syntax Highlighting in Code Blocks
 
-VitePress uses [Shiki](https://github.com/shikijs/shiki) to highlight language syntax in Markdown code blocks, using coloured text. Shiki supports a wide variety of programming languages. All you need to do is append a valid language alias to the beginning backticks for the code block:
+VitePress uses [Shiki](https://github.com/shikijs/shiki) to highlight language syntax in Markdown code blocks, using colored text. Shiki supports a wide variety of programming languages. All you need to do is append a valid language alias to the beginning backticks for the code block:
 
 **Input**
 
@@ -343,7 +343,7 @@ export default {
 
 A [list of valid languages](https://shiki.style/languages) is available on Shiki's repository.
 
-You may also customize syntax highlight theme in app config. Please see [`markdown` options](../reference/site-config#markdown) for more details.
+You may also customize the syntax highlighting theme in the app config. Please see [`markdown` options](../reference/site-config#markdown) for more details.
 
 ## Line Highlighting in Code Blocks
 
@@ -445,7 +445,7 @@ export default {
 
 Adding the `// [!code focus]` comment on a line will focus it and blur the other parts of the code.
 
-Additionally, you can define a number of lines to focus using `// [!code focus:<lines>]`.
+Additionally, you can define a set number of lines to place in focus using `// [!code focus:<lines>]`.
 
 **Input**
 
@@ -475,7 +475,7 @@ export default {
 
 ## Colored Diffs in Code Blocks
 
-Adding the `// [!code --]` or `// [!code ++]` comments on a line will create a diff of that line, while keeping the colors of the codeblock.
+Adding the `// [!code --]` or `// [!code ++]` comments on a line will create a diff of that line while keeping the colors of the code-block.
 
 **Input**
 
@@ -539,7 +539,7 @@ export default {
 
 ## Line Numbers
 
-You can enable line numbers for each code blocks via config:
+You can enable line numbers for all code blocks via config:
 
 ```js
 export default {
@@ -551,7 +551,7 @@ export default {
 
 Please see [`markdown` options](../reference/site-config#markdown) for more details.
 
-You can add `:line-numbers` / `:no-line-numbers` mark in your fenced code blocks to override the value set in config.
+You can add a `:line-numbers` / `:no-line-numbers` mark into your fenced code blocks as needed to override the value set in the config.
 
 You can also customize the starting line number by adding `=` after `:line-numbers`. For example, `:line-numbers=2` means the line numbers in code blocks will start from `2`.
 
@@ -599,7 +599,7 @@ const line4 = 'This is line 4'
 
 ## Import Code Snippets
 
-You can import code snippets from existing files via following syntax:
+You can import code snippets from existing files via the following syntax:
 
 ```md
 <<< @/filepath
@@ -626,7 +626,7 @@ It also supports [line highlighting](#line-highlighting-in-code-blocks):
 <<< @/snippets/snippet.js{2}
 
 ::: tip
-The value of `@` corresponds to the source root. By default it's the VitePress project root, unless `srcDir` is configured. Alternatively, you can also import from relative paths:
+The value of `@` corresponds to the source root. By default, it's the VitePress project root, unless `srcDir` is configured. Alternatively, you can also import from relative paths:
 
 ```md
 <<< ../snippets/snippet.js
@@ -634,7 +634,7 @@ The value of `@` corresponds to the source root. By default it's the VitePress p
 
 :::
 
-You can also use a [VS Code region](https://code.visualstudio.com/docs/editor/codebasics#_folding) to only include the corresponding part of the code file. You can provide a custom region name after a `#` following the filepath:
+You can also use a [VS Code region](https://code.visualstudio.com/docs/editor/codebasics#_folding) to only include the corresponding part of the code file. You can provide a custom region name after a `#` following the base filepath:
 
 **Input**
 
@@ -664,7 +664,7 @@ You can also specify the language inside the braces (`{}`) like this:
 <<< @/snippets/snippet.cs{1,2,4-6 c#:line-numbers}
 ```
 
-This is helpful if source language cannot be inferred from your file extension.
+This is helpful if a source language cannot be inferred from your file extension.
 
 ## Code Groups
 
@@ -964,4 +964,4 @@ export default defineConfig({
 })
 ```
 
-See full list of configurable properties in [Config Reference: App Config](../reference/site-config#markdown).
+You can full list of configurable properties on the [Config Reference: App Config](../reference/site-config#markdown) page.

From a73fe0b13e866cda485245e007e208a2b9442408 Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 03:15:36 -0500
Subject: [PATCH 10/25] Update migration-from-vitepress-0.md

---
 docs/en/guide/migration-from-vitepress-0.md | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/docs/en/guide/migration-from-vitepress-0.md b/docs/en/guide/migration-from-vitepress-0.md
index 29ab9a2a39c1..7ec0edc6ea05 100644
--- a/docs/en/guide/migration-from-vitepress-0.md
+++ b/docs/en/guide/migration-from-vitepress-0.md
@@ -1,6 +1,6 @@
 # Migration from VitePress 0.x
 
-If you're coming from VitePress 0.x version, there're several breaking changes due to new features and enhancement. Please follow this guide to see how to migrate your app over to the latest VitePress.
+If you're coming from a VitePress 0.x version, there are several breaking changes due to new features and enhancements. Please follow this guide to see how to migrate your app over to the latest VitePress.
 
 ## App Config
 
@@ -10,14 +10,14 @@ If you're coming from VitePress 0.x version, there're several breaking changes d
 
 - `sidebar` option has changed its structure.
   - `children` key is now named `items`.
-  - Top level item may not contain `link` at the moment. We're planning to bring it back.
+  - Top-level items may not contain `link` at the moment. We're planning to bring it back.
 - `repo`, `repoLabel`, `docsDir`, `docsBranch`, `editLinks`, `editLinkText` are removed in favor of more flexible api.
-  - For adding GitHub link with icon to the nav, use [Social Links](../reference/default-theme-nav#navigation-links) feature.
-  - For adding "Edit this page" feature, use [Edit Link](../reference/default-theme-edit-link) feature.
-- `lastUpdated` option is now split into `config.lastUpdated` and `themeConfig.lastUpdatedText`.
+  - For adding GitHub link(s) with icon(s) to the nav, use the [Social Links](../reference/default-theme-nav#navigation-links) feature.
+  - For adding "Edit this page" feature, use the [Edit Link](../reference/default-theme-edit-link) feature.
+- The `lastUpdated` option is now split into `config.lastUpdated` and `themeConfig.lastUpdatedText`.
 - `carbonAds.carbon` is changed to `carbonAds.code`.
 
 ## Frontmatter Config
 
-- `home: true` option has changed to `layout: home`. Also, many Homepage related settings have been modified to provide additional features. See [Home Page guide](../reference/default-theme-home-page) for details.
-- `footer` option is moved to [`themeConfig.footer`](../reference/default-theme-config#footer).
+- The `home: true` option has changed to `layout: home`. In addition, many Homepage-related settings have been modified to provide additional features. See [Home Page guide](../reference/default-theme-home-page) for details.
+- The `footer` option has moved to [`themeConfig.footer`](../reference/default-theme-config#footer).

From e8df271ff1047b514160aa04206dcc104fb778f5 Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 03:16:56 -0500
Subject: [PATCH 11/25] Update migration-from-vuepress.md

---
 docs/en/guide/migration-from-vuepress.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/en/guide/migration-from-vuepress.md b/docs/en/guide/migration-from-vuepress.md
index 01e4c170d4ce..b00c92c81ef5 100644
--- a/docs/en/guide/migration-from-vuepress.md
+++ b/docs/en/guide/migration-from-vuepress.md
@@ -10,9 +10,9 @@ The sidebar is no longer automatically populated from frontmatter. You can [read
 
 ### Images
 
-Unlike VuePress, VitePress handles [`base`](./asset-handling#base-url) of your config automatically when you use static image.
+Unlike VuePress, VitePress handles [`base`](./asset-handling#base-url) of your config automatically when you use a static image.
 
-Hence, now you can render images without `img` tag.
+As a result, you can render images without needing an `img` tag.
 
 ```diff
 - <img :src="$withBase('/foo.png')" alt="foo">
@@ -20,7 +20,7 @@ Hence, now you can render images without `img` tag.
 ```
 
 ::: warning
-For dynamic images you still need `withBase` as shown in [Base URL guide](./asset-handling#base-url).
+For dynamic images, you still need `withBase` as shown in [Base URL guide](./asset-handling#base-url).
 :::
 
 Use `<img.*withBase\('(.*)'\).*alt="([^"]*)".*>` regex to find and replace it with `![$2]($1)` to replace all the images with `![](...)` syntax.

From 98689707985510a6c0d49d8c358f61a518927fe2 Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 03:19:00 -0500
Subject: [PATCH 12/25] Update mpa-mode.md

---
 docs/en/guide/mpa-mode.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/en/guide/mpa-mode.md b/docs/en/guide/mpa-mode.md
index 74b6c297aa01..aaf017c419a5 100644
--- a/docs/en/guide/mpa-mode.md
+++ b/docs/en/guide/mpa-mode.md
@@ -1,12 +1,12 @@
 # MPA Mode <Badge type="warning" text="experimental" />
 
-MPA (Multi-Page Application) mode can be enabled via the command line via `vitepress build --mpa`, or via config through the `mpa: true` option.
+MPA (Multi-Page Application) mode can be enabled via the command line by running `vitepress build --mpa`, or through config via the `mpa: true` option.
 
 In MPA mode, all pages are rendered without any JavaScript included by default. As a result, the production site will likely have a better initial visit performance score from audit tools.
 
-However, due to the absence of SPA navigation, cross-page links will lead to full page reloads. Post-load navigations in MPA mode will not feel as instant as in SPA mode.
+However, due to the absence of SPA navigation, cross-page links will lead to full-page reloads. Post-load navigations in MPA mode will not feel as instant as in SPA mode.
 
-Also note that no-JS-by-default means you are essentially using Vue purely as a server-side templating language. No event handlers will be attached in the browser, so there will be no interactivity. To load client-side JavaScript, you will need to use the special `<script client>` tag:
+It should also be noted that no-JS-by-default means you are essentially using Vue purely as a server-side templating language. No event handlers will be attached in the browser, so there will be no interactivity. To load client-side JavaScript, you will need to use the special `<script client>` tag:
 
 ```html
 <script client>
@@ -18,6 +18,6 @@ document.querySelector('h1').addEventListener('click', () => {
 # Hello
 ```
 
-`<script client>` is a VitePress-only feature, not a Vue feature. It works in both `.md` and `.vue` files, but only in MPA mode. Client scripts in all theme components will be bundled together, while client script for a specific page will be split for that page only.
+`<script client>` is a VitePress-only feature, not a Vue feature. It works in both `.md` and `.vue` files, but only in MPA mode. Client scripts in all theme components will be bundled together, while client scripts for a specific page will be split for that page only.
 
-Note that `<script client>` is **not evaluated as Vue component code**: it's processed as a plain JavaScript module. For this reason, MPA mode should only be used if your site requires absolutely minimal client-side interactivity.
+Note that `<script client>` is **not evaluated as Vue component code**: it's processed as a plain JavaScript module. For this reason, MPA mode should only be used if your site requires either no interactivity or absolutely minimal client-side interactivity.

From 17e122af96d9d9baf74e29e5d230c2f34d217a4f Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 03:24:06 -0500
Subject: [PATCH 13/25] Update routing.md

---
 docs/en/guide/routing.md | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/docs/en/guide/routing.md b/docs/en/guide/routing.md
index 945e63c0fceb..d784a4ec83d3 100644
--- a/docs/en/guide/routing.md
+++ b/docs/en/guide/routing.md
@@ -6,7 +6,7 @@ outline: deep
 
 ## File-Based Routing
 
-VitePress uses file-based routing, which means the generated HTML pages are mapped from the directory structure of the source Markdown files. For example, given the following directory structure:
+VitePress uses file-based routing, which means that generated HTML pages are mapped from the directory structure of the source Markdown files. For example, given the following directory structure:
 
 ```
 .
@@ -34,9 +34,9 @@ There are two important concepts in the file structure of a VitePress project: t
 
 ### Project Root
 
-Project root is where VitePress will try to look for the `.vitepress` special directory. The `.vitepress` directory is a reserved location for VitePress' config file, dev server cache, build output, and optional theme customization code.
+Project root is where VitePress will try to look for the `.vitepress` special directory. The `.vitepress` directory is a reserved location for the VitePress config file, dev server cache, build output, and optional theme customization code.
 
-When you run `vitepress dev` or `vitepress build` from the command line, VitePress will use the current working directory as project root. To specify a sub-directory as root, you will need to pass the relative path to the command. For example, if your VitePress project is located in `./docs`, you should run `vitepress dev docs`:
+When you run `vitepress dev` or `vitepress build` from the command line, VitePress will use the current working directory as the project root. To specify a sub-directory as root, you will need to pass the relative path to the command. For example, if your VitePress project is located in `./docs`, you should run `vitepress dev docs`:
 
 ```
 .
@@ -60,9 +60,9 @@ docs/getting-started.md  -->  /getting-started.html
 
 ### Source Directory
 
-Source directory is where your Markdown source files live. By default, it is the same as the project root. However, you can configure it via the [`srcDir`](../reference/site-config#srcdir) config option.
+The Source Directory is where your Markdown source files live. By default, it is the same as the project root. However, you can configure it via the [`srcDir`](../reference/site-config#srcdir) config option.
 
-The `srcDir` option is resolved relative to project root. For example, with `srcDir: 'src'`, your file structure will look like this:
+The `srcDir` option is resolved relative to the project root. For example, with `srcDir: 'src'`, your file structure will look like this:
 
 ```
 .                          # project root
@@ -93,7 +93,7 @@ You can use both absolute and relative paths when linking between pages. Note th
 [Getting Started](./getting-started.html)
 ```
 
-Learn more about linking to assets such images in [Asset Handling](./asset-handling).
+You can learn more about linking to assets such as images in [Asset Handling](./asset-handling).
 
 ### Linking to Non-VitePress Pages
 
@@ -137,7 +137,7 @@ Some servers or hosting platforms (for example Netlify, Vercel, GitHub Pages) pr
 If this feature is available to you, you can then also enable VitePress' own [`cleanUrls`](../reference/site-config#cleanurls) config option so that:
 
 - Inbound links between pages are generated without the `.html` extension.
-- If current path ends with `.html`, the router will perform a client-side redirect to the extension-less path.
+- If the current path ends with `.html`, the router will perform a client-side redirect to the extension-less path.
 
 If, however, you cannot configure your server with such support, you will have to manually resort to the following directory structure:
 
@@ -152,7 +152,7 @@ If, however, you cannot configure your server with such support, you will have t
 
 ## Route Rewrites
 
-You can customize the mapping between the source directory structure and the generated pages. It's useful when you have a complex project structure. For example, let's say you have a monorepo with multiple packages, and would like to place documentations along with the source files like this:
+You can customize the mapping between the source directory structure and the generated pages. It's useful when you have a complex project structure. For example, let's say you have a monorepo with multiple packages, and would like to place documentation files along with the source files like this:
 
 ```
 .
@@ -200,7 +200,7 @@ The rewrite paths are compiled using the `path-to-regexp` package - consult [its
 
 ::: warning Relative Links with Rewrites
 
-When rewrites are enabled, **relative links should be based on the rewritten paths**. For example, in order to create a relative link from `packages/pkg-a/src/pkg-a-code.md` to `packages/pkg-b/src/pkg-b-code.md`, you should use:
+When rewrites are enabled, **relative links should be based on the rewritten paths**. For example, to create a relative link from `packages/pkg-a/src/pkg-a-code.md` to `packages/pkg-b/src/pkg-b-code.md`, you should use:
 
 ```md
 [Link to PKG B](../pkg-b/pkg-b-code)
@@ -347,7 +347,7 @@ console.log(params.value)
 
 ### Rendering Raw Content
 
-Params passed to the page will be serialized in the client JavaScript payload, so you should avoid passing heavy data in params, for example raw Markdown or HTML content fetched from a remote CMS.
+Params passed to the page will be serialized in the client JavaScript payload, so you should avoid passing heavy data in params, for example, raw Markdown or HTML content fetched from a remote CMS.
 
 Instead, you can pass such content to each page using the `content` property on each path object:
 

From 1109c0e70e027fa7502ab3f0130ba3af77780d68 Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 03:24:58 -0500
Subject: [PATCH 14/25] Update ssr-compat.md

---
 docs/en/guide/ssr-compat.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/guide/ssr-compat.md b/docs/en/guide/ssr-compat.md
index a7a447d1311a..8f2d9d406821 100644
--- a/docs/en/guide/ssr-compat.md
+++ b/docs/en/guide/ssr-compat.md
@@ -4,7 +4,7 @@ outline: deep
 
 # SSR Compatibility
 
-VitePress pre-renders the app in Node.js during the production build, using Vue's Server-Side Rendering (SSR) capabilities. This means all custom code in theme components are subject to SSR Compatibility.
+VitePress pre-renders the app in Node.js during the production build, using Vue's Server-Side Rendering (SSR) capabilities. This means all custom code in theme components is subject to SSR Compatibility.
 
 The [SSR section in official Vue docs](https://vuejs.org/guide/scaling-up/ssr.html) provides more context on what SSR is, the relationship between SSR / SSG, and common notes on writing SSR-friendly code. The rule of thumb is to only access browser / DOM APIs in `beforeMount` or `mounted` hooks of Vue components.
 

From 878e45a7fb5761c4b73cef15c30b9f2ffde35f7f Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 03:27:22 -0500
Subject: [PATCH 15/25] Update using-vue.md

---
 docs/en/guide/using-vue.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/en/guide/using-vue.md b/docs/en/guide/using-vue.md
index 70d18bce1101..50cb621181a8 100644
--- a/docs/en/guide/using-vue.md
+++ b/docs/en/guide/using-vue.md
@@ -71,7 +71,7 @@ The count is: {{ count }}
 When used in Markdown, `<style scoped>` requires adding special attributes to every element on the current page, which will significantly bloat the page size. `<style module>` is preferred when locally-scoped styling is needed in a page.
 :::
 
-You also have access to VitePress' runtime APIs such as the [`useData` helper](../reference/runtime-api#usedata), which provides access to current page's metadata:
+You also have access to VitePress' runtime APIs such as the [`useData` helper](../reference/runtime-api#usedata), which provides access to the current page's metadata:
 
 **Input**
 
@@ -122,7 +122,7 @@ This is a .md using a custom component
 
 ### Registering Components Globally
 
-If a component is going to be used on most of the pages, they can be registered globally by customizing the Vue app instance. See relevant section in [Extending Default Theme](./extending-default-theme#registering-global-components) for an example.
+If a component is going to be used on several pages, it may be most useful to make it registered globally by customizing the Vue app instance. See the relevant section in [Extending Default Theme](./extending-default-theme#registering-global-components) for an example.
 
 ::: warning IMPORTANT
 Make sure a custom component's name either contains a hyphen or is in PascalCase. Otherwise, it will be treated as an inline element and wrapped inside a `<p>` tag, which will lead to hydration mismatch because `<p>` does not allow block elements to be placed inside it.
@@ -196,7 +196,7 @@ Hello {{ 1 + 1 }}
 Hello {{ 1 + 1 }}
 ```
 
-Note that this might prevent certain tokens from being syntax highlighted properly.
+Note that this may prevent certain tokens from being syntax-highlighted properly.
 
 ## Using CSS Pre-processors
 
@@ -224,7 +224,7 @@ Then you can use the following in Markdown and theme components:
 
 ## Using Teleports
 
-VitePress currently has SSG support for teleports to body only. For other targets, you can wrap them inside the built-in `<ClientOnly>` component or inject the teleport markup into the correct location in your final page HTML through [`postRender` hook](../reference/site-config#postrender).
+VitePress currently has SSG support for teleports to the page body only. For other targets, you can wrap them inside the built-in `<ClientOnly>` component or inject the teleport markup into the correct location in your final page HTML through [`postRender` hook](../reference/site-config#postrender).
 
 <ModalDemo />
 

From 28f98ee04a3ad06119674ebff4b2c01f55c2f3ee Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 03:29:13 -0500
Subject: [PATCH 16/25] Update what-is-vitepress.md

---
 docs/en/guide/what-is-vitepress.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/en/guide/what-is-vitepress.md b/docs/en/guide/what-is-vitepress.md
index a498d17ecda6..505ffb8d52e2 100644
--- a/docs/en/guide/what-is-vitepress.md
+++ b/docs/en/guide/what-is-vitepress.md
@@ -30,11 +30,11 @@ VitePress aims to provide a great Developer Experience (DX) when working with Ma
 
 - **[Built-in Markdown Extensions:](./markdown)** Frontmatter, tables, syntax highlighting... you name it. Specifically, VitePress provides many advanced features for working with code blocks, making it ideal for highly technical documentation.
 
-- **[Vue-Enhanced Markdown:](./using-vue)** each Markdown page is also a Vue [Single-File Component](https://vuejs.org/guide/scaling-up/sfc.html), thanks to Vue template's 100% syntax compatibility with HTML. You can embed interactivity in your static content using Vue templating features or imported Vue components.
+- **[Vue-Enhanced Markdown:](./using-vue)** Each Markdown page is also a Vue [Single-File Component](https://vuejs.org/guide/scaling-up/sfc.html), thanks to Vue templates' 100% syntax compatibility with HTML. You can embed interactivity in your static content using Vue templating features or imported Vue components.
 
 ## Performance
 
-Unlike many traditional SSGs where each navigation results in a full page reload, a website generated by VitePress serves static HTML on the initial visit, but becomes a [Single Page Application](https://en.wikipedia.org/wiki/Single-page_application) (SPA) for subsequent navigation within the site. This model, in our opinion, provides an optimal balance for performance:
+Unlike many traditional SSGs where each navigation results in a full page reload, a website generated by VitePress serves static HTML on the initial visit, then becomes a [Single Page Application](https://en.wikipedia.org/wiki/Single-page_application) (SPA) for subsequent navigation within the site. This model, in our opinion, provides an optimal balance for performance:
 
 - **Fast Initial Load**
 
@@ -42,7 +42,7 @@ Unlike many traditional SSGs where each navigation results in a full page reload
 
 - **Fast Post-load Navigation**
 
-  More importantly, the SPA model leads to better user experience **after** the initial load. Subsequent navigation within the site will no longer cause a full page reload. Instead, the incoming page's content will be fetched and dynamically updated. VitePress also automatically pre-fetches page chunks for links that are within viewport. In most cases, post-load navigation will feel instant.
+  More importantly, the SPA model leads to a better user experience **after** the initial load. Subsequent navigation within the site will no longer cause a full page reload. Instead, the incoming page's content will be fetched and dynamically updated. VitePress also automatically pre-fetches page chunks for links that are within the viewport. In most cases, post-load navigation will feel instant.
 
 - **Interactivity Without Penalty**
 

From 09590f9aae5770172573d10fba55c7a75a790cce Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 03:29:58 -0500
Subject: [PATCH 17/25] Update cli.md

---
 docs/en/reference/cli.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/en/reference/cli.md b/docs/en/reference/cli.md
index 85517620bfaa..dfd2286159d6 100644
--- a/docs/en/reference/cli.md
+++ b/docs/en/reference/cli.md
@@ -2,7 +2,7 @@
 
 ## `vitepress dev`
 
-Start VitePress dev server using designated directory as root. Defaults to current directory. The `dev` command can also be omitted when running in current directory.
+Starts a VitePress dev server using the designated directory as root. Defaults to current directory. The `dev` command can also be omitted when running in the current directory.
 
 ### Usage
 
@@ -65,7 +65,7 @@ vitepress preview [root]
 
 ## `vitepress init`
 
-Start the [Setup Wizard](../guide/getting-started#setup-wizard) in current directory.
+Starts the [Setup Wizard](../guide/getting-started#setup-wizard) in the current directory.
 
 ### Usage
 

From 176e9cd44c1fe4921447e2baf5d7bd06a182b5d1 Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 03:32:56 -0500
Subject: [PATCH 18/25] Update default-theme-badge.md

---
 docs/en/reference/default-theme-badge.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/en/reference/default-theme-badge.md b/docs/en/reference/default-theme-badge.md
index e23fde008c36..79204ab9834d 100644
--- a/docs/en/reference/default-theme-badge.md
+++ b/docs/en/reference/default-theme-badge.md
@@ -1,6 +1,6 @@
 # Badge
 
-The badge lets you add status to your headers. For example, it could be useful to specify the section's type, or supported version.
+The badge lets you add status to your headers. For example, it could be useful to specify the section's type or supported version.
 
 ## Usage
 
@@ -13,7 +13,7 @@ You may use the `Badge` component which is globally available.
 ### Title <Badge type="danger" text="caution" />
 ```
 
-Code above renders like:
+The above code renders as:
 
 ### Title <Badge type="info" text="default" />
 ### Title <Badge type="tip" text="^1.9.0" />
@@ -22,7 +22,7 @@ Code above renders like:
 
 ## Custom Children
 
-`<Badge>` accept `children`, which will be displayed in the badge.
+`<Badge>` accepts `children`, which will be displayed inside of the badge.
 
 ```html
 ### Title <Badge type="info">custom element</Badge>
@@ -56,7 +56,7 @@ You can customize the style of badges by overriding css variables. The following
 
 ## `<Badge>`
 
-`<Badge>` component accepts following props:
+The `<Badge>` component accepts the following properties:
 
 ```ts
 interface Props {

From 5185fc869333260d2b6910b371e5094b3a90a9e3 Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 03:33:48 -0500
Subject: [PATCH 19/25] Update default-theme-carbon-ads.md

---
 docs/en/reference/default-theme-carbon-ads.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/en/reference/default-theme-carbon-ads.md b/docs/en/reference/default-theme-carbon-ads.md
index 1c0c170edda4..bbeb2a4d1c30 100644
--- a/docs/en/reference/default-theme-carbon-ads.md
+++ b/docs/en/reference/default-theme-carbon-ads.md
@@ -1,6 +1,6 @@
 # Carbon Ads
 
-VitePress has built in native support for [Carbon Ads](https://www.carbonads.net/). By defining the Carbon Ads credentials in config, VitePress will display ads on the page.
+VitePress has built-in native support for [Carbon Ads](https://www.carbonads.net/). By defining the Carbon Ads credentials in the config, VitePress will display ads on the page.
 
 ```js
 export default {
@@ -13,10 +13,10 @@ export default {
 }
 ```
 
-These values are used to call carbon CDN script as shown below.
+These values are used to call the carbon CDN script, as shown below:
 
 ```js
 `//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}`
 ```
 
-To learn more about Carbon Ads configuration, please visit [Carbon Ads website](https://www.carbonads.net/).
+To learn more about Carbon Ads configuration, please visit the [Carbon Ads website](https://www.carbonads.net/).

From eef69943cc81ec96e76f7fcf7bc1758a2928f6b1 Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 03:46:38 -0500
Subject: [PATCH 20/25] Update default-theme-config.md

---
 docs/en/reference/default-theme-config.md | 28 +++++++++++------------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/docs/en/reference/default-theme-config.md b/docs/en/reference/default-theme-config.md
index 4a43153893cd..fb2872bb8ee4 100644
--- a/docs/en/reference/default-theme-config.md
+++ b/docs/en/reference/default-theme-config.md
@@ -17,19 +17,19 @@ export default {
 }
 ```
 
-**The options documented on this page only apply to the default theme.** Different themes expect different theme config. When using a custom theme, the theme config object will be passed to the theme so the theme can define conditional behavior based on it.
+**The options documented on this page only apply to the default theme.** Different themes expect different theme configurations. When using a custom theme, the theme config object will be passed to the theme so the theme can define conditional behavior based on it.
 
 ## i18nRouting
 
 - Type: `boolean`
 
-Changing locale to say `zh` will change the URL from `/foo` (or `/en/foo/`) to `/zh/foo`. You can disable this behavior by setting `themeConfig.i18nRouting` to `false`.
+Changing the locale to say `zh` will change the URL from `/foo` (or `/en/foo/`) to `/zh/foo`. You can disable this behavior by setting `themeConfig.i18nRouting` to `false`.
 
 ## logo
 
 - Type: `ThemeableImage`
 
-Logo file to display in nav bar, right before the site title. Accepts a path string, or an object to set a different logo for light/dark mode.
+Sets a Logo file to display in the nav bar, right before the site title. Accepts a path string, or an object to set a different logo for light/dark mode.
 
 ```ts
 export default {
@@ -50,7 +50,7 @@ type ThemeableImage =
 
 - Type: `string | false`
 
-You can customize this item to replace the default site title (`title` in app config) in nav. When set to `false`, title in nav will be disabled. Useful when you have `logo` that already contains the site title text.
+You can customize this item to replace the default site title (`title` in app config) in nav. When set to `false`, the title in nav will be disabled. Useful when you have `logo` that already contains the site title text.
 
 ```ts
 export default {
@@ -64,7 +64,7 @@ export default {
 
 - Type: `NavItem`
 
-The configuration for the nav menu item. More details in [Default Theme: Nav](./default-theme-nav#navigation-links).
+The configuration for the nav menu item. More details can be found in the [Default Theme: Nav](./default-theme-nav#navigation-links) article.
 
 ```ts
 export default {
@@ -112,7 +112,7 @@ interface NavItemWithChildren {
 
 - Type: `Sidebar`
 
-The configuration for the sidebar menu item. More details in [Default Theme: Sidebar](./default-theme-sidebar).
+The configuration for the sidebar menu item. More details can be found in the [Default Theme: Sidebar](./default-theme-sidebar) article.
 
 ```ts
 export default {
@@ -195,7 +195,7 @@ If you want to disable it for all viewports, you should use `outline: false` ins
 - Type: `Outline | Outline['level'] | false`
 - Level can be overridden per page via [frontmatter](./frontmatter-config#outline)
 
-Setting this value to `false` prevents rendering of outline container. Refer this interface for more details:
+Setting this value to `false` prevents the rendering of outline containers. Refer to this interface for more details:
 
 ```ts
 interface Outline {
@@ -222,7 +222,7 @@ interface Outline {
 
 - Type: `SocialLink[]`
 
-You may define this option to show your social account links with icons in nav.
+Setting a definition for this config option will show the provided social account links with icons (if included/provided) in nav.
 
 ```ts
 export default {
@@ -355,7 +355,7 @@ export interface LastUpdatedOptions {
 
 - Type: `AlgoliaSearch`
 
-An option to support searching your docs site using [Algolia DocSearch](https://docsearch.algolia.com/docs/what-is-docsearch). Learn more in [Default Theme: Search](./default-theme-search)
+A toggleable option to support searching your docs site using [Algolia DocSearch](https://docsearch.algolia.com/docs/what-is-docsearch). Learn more on the [Default Theme: Search](./default-theme-search) page.
 
 ```ts
 export interface AlgoliaSearchOptions extends DocSearchProps {
@@ -363,7 +363,7 @@ export interface AlgoliaSearchOptions extends DocSearchProps {
 }
 ```
 
-View full options [here](https://github.com/vuejs/vitepress/blob/main/types/docsearch.d.ts).
+You can view a full list of all options [here](https://github.com/vuejs/vitepress/blob/main/types/docsearch.d.ts).
 
 ## carbonAds {#carbon-ads}
 
@@ -389,7 +389,7 @@ export interface CarbonAdsOptions {
 }
 ```
 
-Learn more in [Default Theme: Carbon Ads](./default-theme-carbon-ads)
+Learn more on the [Default Theme: Carbon Ads](./default-theme-carbon-ads) page.
 
 ## docFooter
 
@@ -427,7 +427,7 @@ Can be used to customize the dark mode switch label. This label is only displaye
 - Type: `string`
 - Default: `Switch to light theme`
 
-Can be used to customize the light mode switch title that appears on hovering.
+Can be used to customize the light mode switch title that appears when hovering over it.
 
 ## darkModeSwitchTitle
 
@@ -455,11 +455,11 @@ Can be used to customize the label of the return to top button. This label is on
 - Type: `string`
 - Default: `Change language`
 
-Can be used to customize the aria-label of the language toggle button in navbar. This is only used if you're using [i18n](../guide/i18n).
+Allows for customization of the aria-label of the language toggle button on the navbar. This is only used if you're using [i18n](../guide/i18n).
 
 ## externalLinkIcon
 
 - Type: `boolean`
 - Default: `false`
 
-Whether to show an external link icon next to external links in markdown.
+Toggles whether to show an external link icon next to external links in markdown.

From d48c55a398ea9842374abfc0daeff2c9c1b5296c Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 03:49:18 -0500
Subject: [PATCH 21/25] Update default-theme-edit-link.md

---
 docs/en/reference/default-theme-edit-link.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/en/reference/default-theme-edit-link.md b/docs/en/reference/default-theme-edit-link.md
index ff049d59e3a9..7a4f5b9a5941 100644
--- a/docs/en/reference/default-theme-edit-link.md
+++ b/docs/en/reference/default-theme-edit-link.md
@@ -2,7 +2,7 @@
 
 ## Site-Level Config
 
-Edit Link lets you display a link to edit the page on Git management services such as GitHub, or GitLab. To enable it, add `themeConfig.editLink` options to your config.
+The Edit Link option lets you display a link to edit the page on Git management services such as GitHub, or GitLab. To enable it, add the `themeConfig.editLink` option to your config.
 
 ```js
 export default {
@@ -14,9 +14,9 @@ export default {
 }
 ```
 
-The `pattern` option defines the URL structure for the link, and `:path` is going to be replaced with the page path.
+The `pattern` option defines the URL structure for the link, where `:path` will automatically be replaced with the page path.
 
-You can also put a pure function that accepts [`PageData`](./runtime-api#usedata) as the argument and returns the URL string.
+You can also create a pure function that accepts [`PageData`](./runtime-api#usedata) as the argument to return the URL string.
 
 ```js
 export default {
@@ -34,7 +34,7 @@ export default {
 }
 ```
 
-It should not have side-effects nor access anything outside of its scope since it will be serialized and executed in the browser.
+This option should not have side effects nor access anything outside of its scope, as it is serialized and executed in the browser.
 
 By default, this will add the link text "Edit this page" at the bottom of the doc page. You may customize this text by defining the `text` option.
 
@@ -51,7 +51,7 @@ export default {
 
 ## Frontmatter Config
 
-This can be disabled per-page using the `editLink` option on frontmatter:
+This can be disabled on a per-page basis using the `editLink` option on frontmatter:
 
 ```yaml
 ---

From 9a24107d9affb2452d39f9319131df765d3a044a Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 03:50:22 -0500
Subject: [PATCH 22/25] Update default-theme-footer.md

---
 docs/en/reference/default-theme-footer.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/en/reference/default-theme-footer.md b/docs/en/reference/default-theme-footer.md
index a58e8ac6b198..7c2bb3062ae9 100644
--- a/docs/en/reference/default-theme-footer.md
+++ b/docs/en/reference/default-theme-footer.md
@@ -1,6 +1,6 @@
 # Footer
 
-VitePress will display global footer at the bottom of the page when `themeConfig.footer` is present.
+VitePress will display the global footer at the bottom of the page when `themeConfig.footer` is present.
 
 ```ts
 export default {
@@ -37,14 +37,14 @@ export default {
 ```
 
 ::: warning
-Only inline elements can be used in `message` and `copyright` as they are rendered inside a `<p>` element. If you want to add block elements, consider using [`layout-bottom`](../guide/extending-default-theme#layout-slots) slot instead.
+Only inline elements can be used in `message` and `copyright` as they are rendered inside a `<p>` element. If you want to add block elements, consider using the [`layout-bottom`](../guide/extending-default-theme#layout-slots) slot instead.
 :::
 
-Note that footer will not be displayed when the [SideBar](./default-theme-sidebar) is visible.
+Note that the footer will not be displayed when the [SideBar](./default-theme-sidebar) is visible.
 
 ## Frontmatter Config
 
-This can be disabled per-page using the `footer` option on frontmatter:
+This can be disabled on a per-page basis using the `footer` option on frontmatter:
 
 ```yaml
 ---

From 5430a9bdc5cafb152e23c008db015024ef685e17 Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 03:52:34 -0500
Subject: [PATCH 23/25] Update default-theme-home-page.md

---
 docs/en/reference/default-theme-home-page.md | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/docs/en/reference/default-theme-home-page.md b/docs/en/reference/default-theme-home-page.md
index f7baecca0138..6c74c460ad33 100644
--- a/docs/en/reference/default-theme-home-page.md
+++ b/docs/en/reference/default-theme-home-page.md
@@ -1,6 +1,6 @@
 # Home Page
 
-VitePress default theme provides a homepage layout, which you can also see used on [the homepage of this site](../). You may use it on any of your pages by specifying `layout: home` in the [frontmatter](./frontmatter-config).
+VitePress' default theme provides a homepage layout, which you can also see used on [the homepage of this site](../). You may use it on any of your pages by specifying `layout: home` in the [frontmatter](./frontmatter-config).
 
 ```yaml
 ---
@@ -8,7 +8,7 @@ layout: home
 ---
 ```
 
-However, this option alone wouldn't do much. You can add several different pre templated "sections" to the homepage by setting additional other options such as `hero` and `features`.
+However, this option alone wouldn't do much. You can add several different pre-made template "sections" to the homepage by setting additional other options such as `hero` and `features`.
 
 ## Hero Section
 
@@ -37,8 +37,8 @@ hero:
 
 ```ts
 interface Hero {
-  // The string shown top of `text`. Comes with brand color
-  // and expected to be short, such as product name.
+  // The string shown top of `text`. Comes with the brand color
+  // and expected to be short, such as a product name.
   name?: string
 
   // The main text for the hero section. This will be defined
@@ -51,7 +51,7 @@ interface Hero {
   // The image is displayed next to the text and tagline area.
   image?: ThemeableImage
 
-  // Action buttons to display in home hero section.
+  // Action buttons to display in the home hero section.
   actions?: HeroAction[]
 }
 
@@ -88,7 +88,7 @@ VitePress uses the brand color (`--vp-c-brand-1`) for the `name`. However, you m
 }
 ```
 
-Also you may customize it further by combining `--vp-home-hero-name-background` to give the `name` gradient color.
+You may also customize it further by combining `--vp-home-hero-name-background` to give the `name` a gradient color.
 
 ```css
 :root {
@@ -99,9 +99,9 @@ Also you may customize it further by combining `--vp-home-hero-name-background`
 
 ## Features Section
 
-In Features section, you can list any number of features you would like to show right after the Hero section. To configure it, pass `features` option to the frontmatter.
+In the Features section, you can list any number of features you would like to show right after the Hero section. To configure it, pass the `features` option to the frontmatter.
 
-You can provide an icon for each feature, which can be an emoji or any type of image. When the configured icon is an image (svg, png, jpeg...), you must provide the icon with the proper width and height; you can also provide the description, its intrinsic size as well as its variants for dark and light theme when required.
+You can provide an icon for each feature, which can be an emoji or any type of image. When the configured icon is an image (svg, png, jpeg...), you must provide the icon with the proper width and height; you can also provide the description, its intrinsic size, as well as its variants for dark and light themes when required.
 
 ```yaml
 ---

From 3f4c23ceb45333e64c9bf4da9a470de4dc51483e Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 03:53:57 -0500
Subject: [PATCH 24/25] Update default-theme-last-updated.md

---
 docs/en/reference/default-theme-last-updated.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/en/reference/default-theme-last-updated.md b/docs/en/reference/default-theme-last-updated.md
index 00fed72a08e8..000182485e4d 100644
--- a/docs/en/reference/default-theme-last-updated.md
+++ b/docs/en/reference/default-theme-last-updated.md
@@ -1,6 +1,6 @@
 # Last Updated
 
-The update time of the last content will be displayed in the lower right corner of the page. To enable it, add `lastUpdated` options to your config.
+The update time of the last content will be displayed in the lower right-hand corner of the page. To enable it, add `lastUpdated` options to your config.
 
 ::: tip
 You need to commit the markdown file to see the updated time.
@@ -16,7 +16,7 @@ export default {
 
 ## Frontmatter Config
 
-This can be disabled per-page using the `lastUpdated` option on frontmatter:
+This can be disabled on a per-page basis by using the `lastUpdated` option on frontmatter:
 
 ```yaml
 ---
@@ -24,4 +24,4 @@ lastUpdated: false
 ---
 ```
 
-Also refer [Default Theme: Last Updated](./default-theme-config#lastupdated) for more details. Any truthy value at theme-level will also enable the feature unless explicitly disabled at site or page level.
+Also refer to [Default Theme: Last Updated](./default-theme-config#lastupdated) for more details. Any truthy value at the theme level will also enable the feature unless explicitly disabled at the site or page level.

From 3f7242bb2ce1cd9a615c7a65c54a6824001e2a0c Mon Sep 17 00:00:00 2001
From: Polaris <37720445+PolarisWasInDenial@users.noreply.github.com>
Date: Thu, 18 Jul 2024 08:22:50 -0500
Subject: [PATCH 25/25] Update default-theme-layout.md

---
 docs/en/reference/default-theme-layout.md | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/docs/en/reference/default-theme-layout.md b/docs/en/reference/default-theme-layout.md
index 246e20fa9f04..c348dd5694c2 100644
--- a/docs/en/reference/default-theme-layout.md
+++ b/docs/en/reference/default-theme-layout.md
@@ -1,6 +1,6 @@
 # Layout
 
-You may choose the page layout by setting `layout` option to the page [frontmatter](./frontmatter-config). There are 3 layout options, `doc`, `page`, and `home`. If nothing is specified, then the page is treated as `doc` page.
+You may choose the page layout by setting the `layout` option to the page [frontmatter](./frontmatter-config). There are 3 layout options, `doc`, `page`, and `home`. If nothing is specified, then the page is treated as `doc` page.
 
 ```yaml
 ---
@@ -10,11 +10,11 @@ layout: doc
 
 ## Doc Layout
 
-Option `doc` is the default layout and it styles the whole Markdown content into "documentation" look. It works by wrapping whole content within `vp-doc` css class, and applying styles to elements underneath it.
+Option `doc` is the default layout and it styles the whole Markdown content into a "documentation" look. It works by wrapping whole content within `vp-doc` css class, and applying styles to elements underneath it.
 
 Almost all generic elements such as `p`, or `h2` get special styling. Therefore, keep in mind that if you add any custom HTML inside a Markdown content, those will get affected by those styles as well.
 
-It also provides documentation specific features listed below. These features are only enabled in this layout.
+It also provides some documentation-specific features, which are listed below. These features are only enabled in this layout:
 
 - Edit Link
 - Prev Next Link
@@ -23,19 +23,19 @@ It also provides documentation specific features listed below. These features ar
 
 ## Page Layout
 
-Option `page` is treated as "blank page". The Markdown will still be parsed, and all of the [Markdown Extensions](../guide/markdown) work as same as `doc` layout, but it wouldn't get any default stylings.
+Option `page` is treated as a "blank page". The Markdown will still be parsed, and all of the [Markdown Extensions](../guide/markdown) work as same as with the `doc` layout, but it wouldn't get any default stylings.
 
-The page layout will let you style everything by you without VitePress theme affecting the markup. This is useful when you want to create your own custom page.
+The page layout will let you style everything yourself without the VitePress theme affecting the markup. This is useful when you want to create your own custom page.
 
-Note that even in this layout, sidebar will still show up if the page has a matching sidebar config.
+Note that even in this layout, the sidebar will still show up if the page has a matching sidebar config.
 
 ## Home Layout
 
-Option `home` will generate templated "Homepage". In this layout, you can set extra options such as `hero` and `features` to customize the content further. Please visit [Default Theme: Home Page](./default-theme-home-page) for more details.
+Option `home` will generate a "Homepage" template. In this layout, you can set extra options such as `hero` and `features` to customize the content further. Please visit the [Default Theme: Home Page](./default-theme-home-page) page for more details.
 
 ## No Layout
 
-If you don't want any layout, you can pass `layout: false` through frontmatter. This option is helpful if you want a fully-customizable landing page (without any sidebar, navbar, or footer by default).
+If you don't want any layout, you can pass `layout: false` through frontmatter. This option is helpful if you want a fully customizable landing page (without any sidebar, navbar, or footer by default).
 
 ## Custom Layout