diff --git a/src/content/docs/en/guides/upgrade-to/v3.mdx b/src/content/docs/en/guides/upgrade-to/v3.mdx
index fd3fba8213159..2ae6eed3edfc4 100644
--- a/src/content/docs/en/guides/upgrade-to/v3.mdx
+++ b/src/content/docs/en/guides/upgrade-to/v3.mdx
@@ -169,9 +169,9 @@ Otherwise, delete all references to importing Astro's `<Markdown />` component a
 
 ### Removed: deprecated 1.x APIs
 
-In Astro v1.x, Astro deprecated config options as well as script/style `global` and `hoist` attributes types. These were kept for backwards compatibility.
+In Astro v1.x, Astro deprecated our original configuration settings as well as `<style global>` and `<script hoist>` support. However, these were still supported for backwards compatibility.
 
-Astro v3.0 removes these deprecated APIs entirely. They can no longer be used in your Astro project.
+Astro v3.0 removes these deprecated APIs entirely. The officially supported [configuration settings](/en/reference/configuration-reference/) and modern `<style is:global>` and `<script>` syntax should be used instead.
 
 #### What should I do?