docs: improve content quality from audit

- Add answer-first opening to introduction
- Fix typo: familar -> familiar
- Add warning callout for module ordering
- Improve StackBlitz link descriptions
- Restructure troubleshooting with key facts first

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>

Author: harlan-zw

docs/content/1.getting-started/0.introduction.md

@@ -5,13 +5,13 @@ navigation:
   title: 'Introduction'
 ---
 
+Nuxt SEO is a collection of Nuxt modules that handle [technical SEO](/learn/mastering-meta/getting-started/why-seo-matters) automatically, including sitemaps, robots.txt, Schema.org, and OG images. It combines 6 focused modules into one unified solution.
+
 ## Background
 
 Technical SEO is tricky and boring. It requires many moving parts that need to work well together. Configuring all of these parts correctly is a challenge.
 
-## Nuxt SEO
-
-Nuxt SEO is the collective name of modules focused on improving your technical SEO.
+## Modules
 
 :AllModules
 

docs/content/1.getting-started/1.installation.md

@@ -29,6 +29,6 @@ See the [Using the Modules](/docs/nuxt-seo/guides/using-the-modules) guide to le
 If you run into any issues, check out the [Troubleshooting](/docs/nuxt-seo/getting-started/troubleshooting) guide. Below
 are the StackBlitz playgrounds for Nuxt SEO:
 
-- [Basic](https://stackblitz.com/edit/nuxt-starter-gfrej6?file=nuxt.config.ts)
-- [I18n](https://stackblitz.com/edit/nuxt-starter-dh68fjqb?file=nuxt.config.ts)
-- [Nuxt Content](https://stackblitz.com/edit/nuxt-starter-xlkqkcqr?file=nuxt.config.ts)
+- [Basic Setup Example](https://stackblitz.com/edit/nuxt-starter-gfrej6?file=nuxt.config.ts)
+- [I18n Integration Example](https://stackblitz.com/edit/nuxt-starter-dh68fjqb?file=nuxt.config.ts)
+- [Nuxt Content Integration Example](https://stackblitz.com/edit/nuxt-starter-xlkqkcqr?file=nuxt.config.ts)

docs/content/1.getting-started/3.troubleshooting.md

@@ -24,15 +24,16 @@ Yes! Nuxt SEO is designed to be flexible and work however you need it to.
 
 ### Why does my production build go up so much?
 
-Nuxt SEO includes many features that only run on the server. These server-side features can increase the size of your
-production build by a few megabytes, but won't affect the performance of your site as the modules are lazy loaded.
+Server-side features add 2-5MB to the production build but don't affect runtime performance since modules are lazy loaded.
+
+Nuxt SEO includes many features that only run on the server.
 
 If the production build size is a concern, you can [disable the modules](/docs/nuxt-seo/guides/using-the-modules) you don't need.
 
 If you are using Nuxt SEO in a serverless environment, you may want to keep your workers under 1mb. The module that
 will contribute the most to your worker size is `nuxt-og-image`.
 
-If you are not using `ogImage`, you can disable it, otherwise consider using [Zero Runtime](/docs/og-image/guides/zero-runtime) mode.
+If you are not using `ogImage`, you can disable it, otherwise consider using [Zero Runtime](/docs/og-image/guides/zero-runtime) mode to prerender images at build time.
 
 ### What happened To Nuxt SEO Kit?
 

docs/content/2.guides/0.using-the-modules.md

@@ -5,7 +5,7 @@ description: A quick guide on which features are available on activating Nuxt SE
 
 ## Introduction
 
-Nuxt SEO is a collection of 6 modules, while most will just work-out-of-the-box, there may be some configuration needed
+Nuxt SEO is a collection of 6 modules. Most work out-of-the-box, but some configuration may be needed
 depending on your site's requirements.
 
 This guide will give you a quick overview of each module and what you need to do to get started.
@@ -53,7 +53,7 @@ See [I18n Robots](/docs/robots/guides/i18n) for more information.
 Generate dynamic Open Graph images for your pages.
 
 - Opt-in, by default, it won't do anything unless you configure it.
-- See the [Tutorial: Getting Familiar With Nuxt OG Image](/docs/og-image/getting-started/getting-familar-with-nuxt-og-image) docs on setting it up.
+- See the [Tutorial: Getting Familiar With Nuxt OG Image](/docs/og-image/getting-started/getting-familiar-with-nuxt-og-image) docs on setting it up.
 
 Note: If you don't intend to generate dynamic images, it's recommended to [disable this module](/docs/nuxt-seo/guides/disabling-modules).
 

docs/content/2.guides/2.nuxt-content.md

@@ -62,7 +62,9 @@ useSeoMeta(page.value.seo || {}) // <-- useSeoMeta
 </script>
 ```
 
-Due to current Nuxt Content v3 limitations, you must load the Nuxt SEO module before the content module.
+::warning
+Due to Nuxt Content v3 limitations, you must load `@nuxtjs/seo` before `@nuxt/content` in your modules array.
+::
 
 ```ts
 export default defineNuxtConfig({