Skip to content

docs: improve SEO descriptions across docs pages#71

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/b0666975
Open

docs: improve SEO descriptions across docs pages#71
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/b0666975

Conversation

@mintlify
Copy link
Copy Markdown

@mintlify mintlify Bot commented May 25, 2026

Summary

Rewrites short, duplicate, and missing frontmatter description fields across 43 documentation pages to improve SEO and search snippet quality.

Changes

  • Added a description to uikit/overview.mdx (was missing).
  • Rewrote 42 descriptions that were under the recommended 130-character threshold so each falls between 130 and 160 characters.
  • Differentiated three duplicate description pairs (Admin API vs Application API: authentication, client libraries, and rate limiting) so every page has a unique description.
  • Each new description summarizes the specific content of the page and includes 2-3 terms a user would likely search for.

Context

Pages with openapi: operation references (Admin API, Application API, and webhook event pages) were left alone — their descriptions are supplied by the OpenAPI spec and overriding them in frontmatter would suppress the spec metadata. Snippet partials under snippets/ were excluded because they are content fragments, not pages.

Titles were audited as well — all existing titles are under 60 characters and describe specific content, so no title changes were needed.

@mintlify
Copy link
Copy Markdown
Author

mintlify Bot commented May 25, 2026

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

Project Status Preview Updated (UTC)
trophy 🟢 Ready View Preview May 25, 2026, 7:14 PM

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.

0 participants