Skip to content

docs: improve short meta descriptions for SEO#6044

Merged
ethanpalm merged 3 commits into
mainfrom
mintlify/4dffb79c
Jun 1, 2026
Merged

docs: improve short meta descriptions for SEO#6044
ethanpalm merged 3 commits into
mainfrom
mintlify/4dffb79c

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented Jun 1, 2026

Summary

Audited all MDX pages and expanded two descriptions that fell below the 130-character SEO threshold.

Changes

  • ai/model-context-protocol.mdx — expanded description from 126 → 149 chars
  • deploy/authentication-setup.mdx — expanded description from 120 → 147 chars (now also mentions password auth)

Context

Full audit of 214 non-localized MDX pages found:

  • No missing/empty titles or descriptions on regular pages
  • No titles over 60 characters
  • No boilerplate PageType - Name titles
  • No descriptions over 160 characters
  • No duplicate descriptions across pages
  • Only the two short descriptions above failed the quality checks

Snippets under snippets/ were excluded (reusable fragments, not pages). The 20 API reference pages with operation-level openapi: refs all have descriptions supplied by the OpenAPI specs — no frontmatter changes needed per the audit rules.


Note

Low Risk
Copy-only frontmatter changes with no runtime, auth, or application logic impact.

Overview
This PR only updates frontmatter description fields on two docs pages so they meet the ~130-character SEO minimum.

On ai/model-context-protocol.mdx, the meta description now says AI tools can search and retrieve content from your site instead of the vaguer “find and retrieve your content.”

On deploy/authentication-setup.mdx, the description is reworded from “Set up” to “Configure” and explicitly lists password alongside OAuth, JWT, and shared links—aligning the snippet with auth options documented on the page.

Reviewed by Cursor Bugbot for commit 846842e. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented Jun 1, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Jun 1, 2026, 9:37 PM

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented Jun 1, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
smartac 🟢 Ready View Preview Jun 1, 2026, 9:38 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented Jun 1, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
testsignup415 🟢 Ready View Preview Jun 1, 2026, 9:38 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Comment thread ai/model-context-protocol.mdx Outdated
Comment thread deploy/authentication-setup.mdx Outdated
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
@ethanpalm ethanpalm merged commit 5432872 into main Jun 1, 2026
6 checks passed
@ethanpalm ethanpalm deleted the mintlify/4dffb79c branch June 1, 2026 22:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants