From d9334de49d5f91ff400155c1c5407c3295cb6207 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 21 Nov 2024 18:42:19 +0000
Subject: [PATCH] Documentation edits made through Mintlify web editor
---
mint.json | 19 ++++++---
settings/seo.mdx | 103 +++++++++++++++++++++++++++++++++--------------
2 files changed, 86 insertions(+), 36 deletions(-)
diff --git a/mint.json b/mint.json
index 0636b03..b6e13a7 100644
--- a/mint.json
+++ b/mint.json
@@ -122,7 +122,8 @@
},
{
"group": "Advanced",
- "pages": [{
+ "pages": [
+ {
"icon": "code",
"group": "Custom Scripts",
"pages": [
@@ -196,7 +197,10 @@
},
{
"group": "SDKs",
- "pages": ["integrations/sdks/speakeasy", "integrations/sdks/stainless"]
+ "pages": [
+ "integrations/sdks/speakeasy",
+ "integrations/sdks/stainless"
+ ]
},
{
"group": "Support",
@@ -208,7 +212,10 @@
},
{
"group": "Privacy",
- "pages": ["integrations/privacy/overview", "integrations/privacy/osano"]
+ "pages": [
+ "integrations/privacy/overview",
+ "integrations/privacy/osano"
+ ]
},
{
"group": "Components",
@@ -240,7 +247,9 @@
},
{
"group": "Changelog",
- "pages": ["changelog/overview"]
+ "pages": [
+ "changelog/overview"
+ ]
}
],
"footer": {
@@ -324,4 +333,4 @@
"publicApiKey": "pk_76a6caa274e800f3ceff0b2bc6b9b9d82ab8"
}
}
-}
+}
\ No newline at end of file
diff --git a/settings/seo.mdx b/settings/seo.mdx
index d4cb06c..37effb8 100644
--- a/settings/seo.mdx
+++ b/settings/seo.mdx
@@ -1,61 +1,86 @@
---
title: 'Search Engine Optimization'
-description: 'Mintlify automatically generates most meta tags. If you want to customize them, you can set default values in mint.json or change them per page.'
+description: 'Customize meta tags and implement SEO best practices in your documentation'
icon: 'magnifying-glass'
---
+## Understanding Meta Tags
+
+Meta tags are pieces of code that help search engines understand your content. Mintlify automatically generates most meta tags, but you can customize them either globally in mint.json or on a per-page basis.
+
-- og:site_name
-- og:title
-- og:description
-- og:url
-- og:image
-- og:locale
-- og:logo
-- article:publisher
-- twitter:title
-- twitter:description
-- twitter:url
-- twitter:image
-- twitter:site
-- og:image:width
-- og:image:height
+- og:site_name - The name of your documentation site
+- og:title - The title of the current page
+- og:description - Brief description of the page content
+- og:url - The URL of the current page
+- og:image - Preview image for social media sharing
+- og:locale - Language/locale of the content
+- og:logo - Your site's logo
+- article:publisher - Publisher information
+- twitter:title - Title for Twitter cards
+- twitter:description - Description for Twitter cards
+- twitter:url - URL for Twitter cards
+- twitter:image - Image for Twitter cards
+- twitter:site - Twitter username associated with the site
+- og:image:width - Width of the og:image
+- og:image:height - Height of the og:image
-## Default meta tags
+## Setting Default Meta Tags
-You can set default meta tags by adding the `metadata` field to your `mint.json`.
+You can set default meta tags that apply to all pages by adding the `metadata` field to your `mint.json`:
```json
"metadata": {
- "og:image": "link to your default meta tag image"
+ "og:image": "https://yoursite.com/path/to/default-image.jpg",
+ "og:site_name": "Your Documentation",
+ "twitter:site": "@yourusername"
}
```
-## Changing meta tags on one page
+## Page-Specific Meta Tags
-Add your meta tags to the page's metadata like so:
+Override default meta tags or add new ones on individual pages by adding them to the page's frontmatter:
```md
---
title: 'Your Example Page Title'
-'og:image': 'link to your meta tag image'
+description: 'A detailed description of this page's content'
+'og:image': 'https://yoursite.com/path/to/page-specific-image.jpg'
+'twitter:title': 'Custom Twitter Title'
---
```
+ Meta tags with colons need to be typed with quotes around them in the page metadata.
+
-Meta tags with colons need to be typed with quotes around them when you put them in the page metadata.
+## Meta Tag Best Practices
-
+### Descriptions
+Write clear, concise descriptions between 150-160 characters that accurately summarize the page content. Good descriptions improve click-through rates from search results.
+
+### Images
+- Use high-quality images with minimum dimensions of 1200x630 pixels for social media previews
+- Compress images to optimize loading speed
+- Include descriptive filenames and alt text
+- Consider providing different images for light/dark modes
+
+### Previewing Meta Tags
+
+Test how your meta tags appear on different platforms:
+- [Twitter Card Validator](https://cards-dev.twitter.com/validator)
+- [Facebook Sharing Debugger](https://developers.facebook.com/tools/debug/)
+- [LinkedIn Post Inspector](https://www.linkedin.com/post-inspector/)
-## Sitemaps
+## Sitemaps and Indexing
-Mintlify automatically generates a `sitemap.xml` file and a `robots.txt` file. Simply add `/sitemap.xml` to the end of your website URL to see your sitemap. We recommend submitting the sitemap to search engines for improved SEO.
+### Sitemaps
+Mintlify automatically generates a `sitemap.xml` file and a `robots.txt` file. Access your sitemap by adding `/sitemap.xml` to your website URL. Submit your sitemap to search engines like Google Search Console and Bing Webmaster Tools for better indexing.
-Only pages included in your `mint.json` are included by default. To include hidden links, add `seo.indexHiddenPages` to your `mint.json`:
+Only pages included in your `mint.json` navigation are included in the sitemap by default. To include hidden pages, add this to your `mint.json`:
```json
"seo": {
@@ -63,10 +88,26 @@ Only pages included in your `mint.json` are included by default. To include hidd
}
```
-## Disabling indexing
-If you want to stop a page from being indexed by search engines, you can include the following in the [frontmatter](/page) of your page:
-```
+### Controlling Indexing
+Prevent specific pages from being indexed by adding `noindex: true` to the page's frontmatter:
+
+```md
---
+title: 'Internal Page'
noindex: true
---
-```
\ No newline at end of file
+```
+
+## Search Engine Tips
+
+1. Use descriptive URLs that include relevant keywords
+2. Create a logical site structure with clear navigation
+3. Ensure your content is mobile-friendly
+4. Optimize page load speeds
+5. Use proper heading hierarchy (H1, H2, H3)
+6. Include internal links to related content
+7. Keep content up to date and relevant
+
+
+ Remember that the best SEO practice is to create high-quality, useful content that genuinely helps your users.
+
\ No newline at end of file