From 7fb907b1525578410b5221c4369ea6c9c26ef596 Mon Sep 17 00:00:00 2001
From: Matthew Phillips <matthew@skypack.dev>
Date: Fri, 26 May 2023 09:17:38 -0400
Subject: [PATCH 1/7] Document inline stylesheets

---
 src/content/docs/en/guides/styling.mdx | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/src/content/docs/en/guides/styling.mdx b/src/content/docs/en/guides/styling.mdx
index 2524ee9019bd2..8bb9642e0ee53 100644
--- a/src/content/docs/en/guides/styling.mdx
+++ b/src/content/docs/en/guides/styling.mdx
@@ -514,6 +514,30 @@ You can apply global styles to your Markdown content by adding [`<style>` tags](
 
 If you are using Tailwind, the [typography plugin](https://tailwindcss.com/docs/typography-plugin) can be useful for styling Markdown.
 
+## Production
+
+### Bundle control
+
+When Astro builds your site for production deployment it combines your CSS into chunks. Each page on your site is its own chunk, and CSS that is shared between multiple pages are split off into their own chunks.
+
+In each of your HTML files there will be `<link rel="stylesheet">` tags added for each of the chunks that the pages needs.
+
+In a site with a large number of pages and many different shared pieces of styles this can some times lead to many requests for styles. Astro has a way to minimize requests through the `inlineStylesheets` option. Using this option Astro will put the (minimized) stylesheet into a `<style>` tag rather than request it externally.
+
+```js
+import { defineConfig } from 'astro/config';
+
+export default defineConfig({
+  build: {
+    inlineStylesheets: 'auto'
+  }
+});
+```
+
+When using the `'auto'` option Astro will inline stylesheets that are below the `vite.build.assetsInlineLimit` threshold. This is usually a good option as bigger sheets, such as global ones used by all pages, will be fetched externally and cached, while smaller sheets, such as a page's own styles, will be inlined.
+
+You can also set this option to `'always'` which will inline all stylesheets.
+
 ## Advanced
 
 :::caution

From 31a5578eb7e77d524b32c5aeaf1e4905c36930ca Mon Sep 17 00:00:00 2001
From: Matthew Phillips <matthew@skypack.dev>
Date: Tue, 30 May 2023 17:44:21 -0400
Subject: [PATCH 2/7] Update src/content/docs/en/guides/styling.mdx

Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
---
 src/content/docs/en/guides/styling.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/en/guides/styling.mdx b/src/content/docs/en/guides/styling.mdx
index 8bb9642e0ee53..0aeccbd74a7bd 100644
--- a/src/content/docs/en/guides/styling.mdx
+++ b/src/content/docs/en/guides/styling.mdx
@@ -534,7 +534,7 @@ export default defineConfig({
 });
 ```
 
-When using the `'auto'` option Astro will inline stylesheets that are below the `vite.build.assetsInlineLimit` threshold. This is usually a good option as bigger sheets, such as global ones used by all pages, will be fetched externally and cached, while smaller sheets, such as a page's own styles, will be inlined.
+The `'auto'` option will inline only the stylesheets that are below the `vite.build.assetsInlineLimit` threshold, reducing the number of requests for smaller sheets. Larger stylesheets, such as global ones used by all pages, will still be fetched externally and cached. This option provides a balance between ...
 
 You can also set this option to `'always'` which will inline all stylesheets.
 

From 8b0b8900bae6b32e90ca5e206cd1dcc59f77703d Mon Sep 17 00:00:00 2001
From: Matthew Phillips <matthew@skypack.dev>
Date: Tue, 30 May 2023 17:44:29 -0400
Subject: [PATCH 3/7] Update src/content/docs/en/guides/styling.mdx

Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
---
 src/content/docs/en/guides/styling.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/en/guides/styling.mdx b/src/content/docs/en/guides/styling.mdx
index 0aeccbd74a7bd..4388d1fbb2879 100644
--- a/src/content/docs/en/guides/styling.mdx
+++ b/src/content/docs/en/guides/styling.mdx
@@ -522,7 +522,7 @@ When Astro builds your site for production deployment it combines your CSS into
 
 In each of your HTML files there will be `<link rel="stylesheet">` tags added for each of the chunks that the pages needs.
 
-In a site with a large number of pages and many different shared pieces of styles this can some times lead to many requests for styles. Astro has a way to minimize requests through the `inlineStylesheets` option. Using this option Astro will put the (minimized) stylesheet into a `<style>` tag rather than request it externally.
+Sites with a large number of pages and many different shared styles can lead to many stylesheet requests and affect site performance. You can configure the `inlineStylesheets` option to reduce the number of these requests by putting (minimized) stylesheets into a `<style>` tag rather than request them externally.
 
 ```js
 import { defineConfig } from 'astro/config';

From 8221a03926a962730d8fa2390168766eee6c7a7b Mon Sep 17 00:00:00 2001
From: Matthew Phillips <matthew@skypack.dev>
Date: Tue, 30 May 2023 17:44:35 -0400
Subject: [PATCH 4/7] Update src/content/docs/en/guides/styling.mdx

Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
---
 src/content/docs/en/guides/styling.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/en/guides/styling.mdx b/src/content/docs/en/guides/styling.mdx
index 4388d1fbb2879..d5be06ca8facc 100644
--- a/src/content/docs/en/guides/styling.mdx
+++ b/src/content/docs/en/guides/styling.mdx
@@ -520,7 +520,7 @@ If you are using Tailwind, the [typography plugin](https://tailwindcss.com/docs/
 
 When Astro builds your site for production deployment it combines your CSS into chunks. Each page on your site is its own chunk, and CSS that is shared between multiple pages are split off into their own chunks.
 
-In each of your HTML files there will be `<link rel="stylesheet">` tags added for each of the chunks that the pages needs.
+In each of your HTML files there will be `<link rel="stylesheet">` tags added, one for each of the chunks that the pages needs.
 
 Sites with a large number of pages and many different shared styles can lead to many stylesheet requests and affect site performance. You can configure the `inlineStylesheets` option to reduce the number of these requests by putting (minimized) stylesheets into a `<style>` tag rather than request them externally.
 

From 3891e01a1d993bc15dfea53469959c0ec354ca7d Mon Sep 17 00:00:00 2001
From: Matthew Phillips <matthew@skypack.dev>
Date: Tue, 30 May 2023 17:44:53 -0400
Subject: [PATCH 5/7] Update src/content/docs/en/guides/styling.mdx

Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
---
 src/content/docs/en/guides/styling.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/en/guides/styling.mdx b/src/content/docs/en/guides/styling.mdx
index d5be06ca8facc..e75d8ca8ec397 100644
--- a/src/content/docs/en/guides/styling.mdx
+++ b/src/content/docs/en/guides/styling.mdx
@@ -518,7 +518,7 @@ If you are using Tailwind, the [typography plugin](https://tailwindcss.com/docs/
 
 ### Bundle control
 
-When Astro builds your site for production deployment it combines your CSS into chunks. Each page on your site is its own chunk, and CSS that is shared between multiple pages are split off into their own chunks.
+When Astro builds your site for production deployment it combines your CSS into chunks. Each page on your site is its own chunk, and additionally, CSS that is shared between multiple pages is further split off into their own chunks for reuse.
 
 In each of your HTML files there will be `<link rel="stylesheet">` tags added, one for each of the chunks that the pages needs.
 

From ab6d1d597f0a42f162f3f0f71d1188914cc0b322 Mon Sep 17 00:00:00 2001
From: Matthew Phillips <matthew@skypack.dev>
Date: Wed, 31 May 2023 12:05:33 -0400
Subject: [PATCH 6/7] Finish the thought

---
 src/content/docs/en/guides/styling.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/en/guides/styling.mdx b/src/content/docs/en/guides/styling.mdx
index e75d8ca8ec397..51745cf96b482 100644
--- a/src/content/docs/en/guides/styling.mdx
+++ b/src/content/docs/en/guides/styling.mdx
@@ -534,7 +534,7 @@ export default defineConfig({
 });
 ```
 
-The `'auto'` option will inline only the stylesheets that are below the `vite.build.assetsInlineLimit` threshold, reducing the number of requests for smaller sheets. Larger stylesheets, such as global ones used by all pages, will still be fetched externally and cached. This option provides a balance between ...
+The `'auto'` option will inline only the stylesheets that are below the `vite.build.assetsInlineLimit` threshold, reducing the number of requests for smaller sheets. Larger stylesheets, such as global ones used by all pages, will still be fetched externally and cached. This option provides a balance between the number of stylesheets loaded and the amount of styles that can be cached between pages.
 
 You can also set this option to `'always'` which will inline all stylesheets.
 

From 58f6c5aa445c0846315e8106c60d0f12aedc6b84 Mon Sep 17 00:00:00 2001
From: Sarah Rainsberger <sarah@rainsberger.ca>
Date: Wed, 31 May 2023 16:15:50 -0300
Subject: [PATCH 7/7] quick number/amount fix!

---
 src/content/docs/en/guides/styling.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/en/guides/styling.mdx b/src/content/docs/en/guides/styling.mdx
index 51745cf96b482..ded5c53be003d 100644
--- a/src/content/docs/en/guides/styling.mdx
+++ b/src/content/docs/en/guides/styling.mdx
@@ -534,7 +534,7 @@ export default defineConfig({
 });
 ```
 
-The `'auto'` option will inline only the stylesheets that are below the `vite.build.assetsInlineLimit` threshold, reducing the number of requests for smaller sheets. Larger stylesheets, such as global ones used by all pages, will still be fetched externally and cached. This option provides a balance between the number of stylesheets loaded and the amount of styles that can be cached between pages.
+The `'auto'` option will inline only the stylesheets that are below the `vite.build.assetsInlineLimit` threshold, reducing the number of requests for smaller sheets. Larger stylesheets, such as global ones used by all pages, will still be fetched externally and cached. This option provides a balance between the number of stylesheets loaded and the styles that can be cached between pages.
 
 You can also set this option to `'always'` which will inline all stylesheets.