Update 20-seo.qmd

Author: rich-iannone

user_guide/20-seo.qmd

@@ -8,7 +8,9 @@ versions: ">=0.2"
 
 # SEO Optimization
 
-Great Docs includes comprehensive search engine optimization (SEO) features to help your documentation rank well in search results. These features are enabled by default and work automatically when you build your site.
+Great Docs includes comprehensive search engine optimization (SEO) features to help your
+documentation rank well in search results. These features are enabled by default and work
+automatically when you build your site.
 
 ## What's Included
 
@@ -77,11 +79,13 @@ great-docs seo --json
 }
 ```
 
-The command exits with code `1` if critical issues are found, making it easy to fail CI builds on SEO problems.
+The command exits with code `1` if critical issues are found, making it easy to fail CI builds on
+SEO problems.
 
 ## Configuration
 
-All SEO settings live under the `seo` key in `great-docs.yml`. Here's the full configuration with defaults:
+All SEO settings live under the `seo` key in `great-docs.yml`. Here's the full configuration with
+defaults:
 
 ```{.yaml filename="great-docs.yml"}
 seo:
@@ -122,11 +126,13 @@ seo:
   default_description: null  # Falls back to package description
 ```
 
-Most users won't need to change these defaults as they're optimized for typical Python documentation sites.
+Most users won't need to change these defaults as they're optimized for typical Python documentation
+sites.
 
 ## Sitemap Configuration
 
-The sitemap tells search engines about all your pages and how often they change. Great Docs generates different priorities and change frequencies based on page type.
+The sitemap tells search engines about all your pages and how often they change. Great Docs
+generates different priorities and change frequencies based on page type.
 
 ### Page Types
 
@@ -167,7 +173,8 @@ seo:
 
 ## Robots.txt Configuration
 
-The `robots.txt` file tells search engine crawlers which pages to index and where to find your sitemap.
+The `robots.txt` file tells search engine crawlers which pages to index and where to find your
+sitemap.
 
 ### Default Behavior
 
@@ -220,11 +227,13 @@ seo:
 
 ## Canonical URLs
 
-Canonical URLs tell search engines which version of a page is the "official" one, preventing duplicate content issues when your site is accessible via multiple URLs.
+Canonical URLs tell search engines which version of a page is the "official" one, preventing
+duplicate content issues when your site is accessible via multiple URLs.
 
 ### Auto-Detection
 
-Great Docs automatically generates canonical URLs based on your GitHub repository. If your repo is `github.com/username/repo`, the canonical base URL will be:
+Great Docs automatically generates canonical URLs based on your GitHub repository. If your repo is
+`github.com/username/repo`, the canonical base URL will be:
 
 ```
 https://username.github.io/repo/
@@ -244,7 +253,8 @@ The trailing slash is important (Great Docs will add it if missing).
 
 ## Page Titles
 
-Great Docs applies a consistent title template to all pages, improving brand recognition in search results.
+Great Docs applies a consistent title template to all pages, improving brand recognition in search
+results.
 
 ### Default Template
 
@@ -272,7 +282,8 @@ seo:
 
 ## Structured Data (JSON-LD)
 
-Great Docs injects [JSON-LD](https://json-ld.org/) structured data into your pages, enabling rich search results with additional context about your software.
+Great Docs injects [JSON-LD](https://json-ld.org/) structured data into your pages, enabling rich
+search results with additional context about your software.
 
 ### What Gets Injected
 
@@ -314,14 +325,15 @@ seo:
 
 ## Meta Descriptions
 
-Meta descriptions appear in search result snippets. Great Docs automatically generates them from your page content.
+Meta descriptions appear in search result snippets. Great Docs automatically generates them from
+your page content.
 
 ### Auto-Generation
 
 For each page, Great Docs extracts a description from:
 
-1. The first meaningful paragraph in the page content
-2. Falls back to the default description if no suitable content is found
+1. the first meaningful paragraph in the page content
+2. falls back to the default description if no suitable content is found
 
 ### Setting a Default Description
 
@@ -347,7 +359,8 @@ description: "How to install My Package using pip, conda, or from source."
 
 ## Noindex for Internal Pages
 
-Some pages shouldn't appear in search results. Great Docs automatically adds `noindex` directives to internal pages like the Skills page.
+Some pages shouldn't appear in search results. Great Docs automatically adds `noindex` directives to
+internal pages like the Skills page.
 
 ### Manual Noindex
 
@@ -411,11 +424,14 @@ seo:
     base_url: https://docs.myproject.com/
 ```
 
-And ensure your DNS is configured correctly (see [Adding a Custom Domain](../recipes/add-custom-domain.qmd)).
+And ensure your DNS is configured correctly (see
+[Adding a Custom Domain](../recipes/add-custom-domain.qmd)).
 
 ## Next Steps
 
-Good SEO makes your documentation discoverable. Great Docs handles the technical foundations (sitemaps, canonical URLs, meta tags) automatically, so you can focus on writing clear titles and descriptions.
+Good SEO makes your documentation discoverable. Great Docs handles the technical foundations
+(sitemaps, canonical URLs, meta tags) automatically, so you can focus on writing clear titles and
+descriptions.
 
 - [Social Cards](social-cards.qmd) controls how links appear when shared on social platforms
 - [Deployment](deployment.qmd) covers publishing to GitHub Pages with SEO settings applied