Consolidate SEO docs and add troubleshooting page

docs.json

@@ -30,7 +30,8 @@
                   "installation",
                   "editor",
                   "ai-native",
-                  "migration"
+                  "migration",
+                  "troubleshooting"
                 ]
               },
               {
@@ -259,7 +260,6 @@
                   "guides/maintenance",
                   "guides/media",
                   "guides/navigation",
-                  "guides/seo",
                   "guides/style-and-tone",
                   "guides/understand-your-audience"
                 ]
@@ -569,7 +569,6 @@
                   "fr/guides/maintenance",
                   "fr/guides/media",
                   "fr/guides/navigation",
-                  "fr/guides/seo",
                   "fr/guides/style-and-tone",
                   "fr/guides/understand-your-audience"
                 ]
@@ -879,7 +878,6 @@
                   "es/guides/maintenance",
                   "es/guides/media",
                   "es/guides/navigation",
-                  "es/guides/seo",
                   "es/guides/style-and-tone",
                   "es/guides/understand-your-audience"
                 ]
@@ -1189,7 +1187,6 @@
                   "zh/guides/maintenance",
                   "zh/guides/media",
                   "zh/guides/navigation",
-                  "zh/guides/seo",
                   "zh/guides/style-and-tone",
                   "zh/guides/understand-your-audience"
                 ]
@@ -1742,6 +1739,10 @@
     {
       "source": "/create/broken-links",
       "destination": "/create/redirects"
+    },
+    {
+      "source": "/guides/seo",
+      "destination": "/optimize/seo"
     }
   ],
   "integrations": {

optimize/seo.mdx

@@ -1,10 +1,14 @@
 ---
 title: "SEO"
 description: "Optimize SEO with meta tag configuration for better search visibility."
-keywords: ["meta tags", "sitemap", "robots.txt", "SEO", "search engine optimization"]
+keywords: ["meta tags", "sitemap", "robots.txt", "SEO", "search engine optimization", "keyword research"]
 ---
 
+<Tip>
+This page covers both technical SEO configuration and content optimization strategies.
+</Tip>
+
 Mintlify automatically handles many SEO best practices, including:
 
 - Meta tag generation
 - Sitemap and `robots.txt` file generation
@@ -25,9 +29,9 @@
 }
 ```
 
 ### Set a canonical URL
 
 If you're using a custom domain, set the `canonical` meta tag to ensure search engines index your preferred domain. A canonical URL tells search engines which version of your documentation is the primary one. This improves SEO when your documentation is accessible from multiple URLs and prevents issues with duplicate content.
 
 ```json
 "seo": {
@@ -41,7 +45,7 @@
 
 To set page-specific meta tags, add them to a page's frontmatter.
 
 The following meta tags are supported at the page level:
 - `title` - Page title
 - `description` - Page description appears below the title on the page and in some search engine results
 - `keywords` - Comma-separated keywords
@@ -55,7 +59,7 @@
 - `twitter:title` - Twitter card title
 - `twitter:description` - Twitter card description
 - `twitter:image` - Twitter card image
 - `twitter:card` - Twitter card type like "summary" or "summary_large_image"
 - `twitter:site` - Twitter site handle
 - `twitter:image:width` - Twitter image width
 - `twitter:image:height` - Twitter image height
@@ -73,17 +77,17 @@
 ```
 
 <Note>
   Meta tags with colons must be wrapped in quotes. The `keywords` field must be formatted as a YAML array.
 </Note>
 
 ## Common meta tags reference
 Below is a comprehensive list of meta tags you can add to your `docs.json`. These meta tags help improve your site's SEO, social sharing, and browser compatibility.
 
 <Note>
   The `og:image` adds a background image that Mintlify automatically overlays with your logo, page title, and description when generating social media previews.
 </Note>
 
 You can preview how your meta tags will appear on different platforms using [metatags.io](https://metatags.io/).
 
 ```json expandable
 "seo": {
@@ -193,11 +197,11 @@
 
 ### Custom sitemaps and robots.txt files
 
 To add a custom `sitemap.xml` or `robots.txt` file, create a `sitemap.xml` or `robots.txt` file at the root of your project. Adding a custom file will override the automatically generated file of the same name. If you delete a custom file, the default file will be used again.
 
 ## Disabling indexing
 
 If you want to stop a page from being indexed by search engines, you can include the following in the [frontmatter](/organize/pages) of your page:
 
 ```
 ---
@@ -215,18 +219,18 @@
   }
 ```
 
 ## SEO best practices
 
 <AccordionGroup>
 <Accordion title="Write descriptive titles and descriptions">
 - Use clear, descriptive page titles (50-60 characters)
 - Write compelling descriptions (150-160 characters) 
 - Include relevant keywords
 - Make each page title and description unique
 </Accordion>
 
 <Accordion title="Optimize your content structure">
 - Use proper heading hierarchy (H1 → H2 → H3)
 - Write for humans first, search engines second
 - Include relevant keywords in headings and content
 - Keep URLs short, descriptive, and organized hierarchically
@@ -242,8 +246,24 @@
 
 <Accordion title="Image SEO">
 - Use descriptive file names for images
 - Always include alt text for accessibility and SEO
 - Optimize image file sizes for faster loading
 - Use relevant images that support your content
 </Accordion>
 </AccordionGroup>
+
+## Page performance
+
+Use tools like [Google PageSpeed Insights](https://pagespeed.web.dev) to identify areas for technical SEO improvement.
+
+Examples of more advanced optimizations:
+
+- **Optimize media for speed:** Compress images using formats like WebP or AVIF and ensure your pages load quickly (ideally under 3 seconds).
+- **Structured data (schema markup):** Add schema markup (like HowTo, FAQ) to your pages to help search engines better understand and rank your content.
+
+## Keyword research
+
+To increase organic traffic, invest time into understanding which keywords help users land on your documentation.
+
+- **Keyword research:** Use free tools like [Google Keyword Planner](https://ads.google.com/intl/en_us/home/tools/keyword-planner/) or [Keywords Everywhere](https://keywordseverywhere.com) to identify common phrases or long-tail keywords.
+- **Integrate keywords naturally:** Add keywords naturally into headings, subheadings, and throughout the body text. Don't overstuff keywords. Your documentation should be written for your users, not search engines.