Skip to content

docs: improve SEO titles and descriptions across docs#60

Open
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/04769b11
Open

docs: improve SEO titles and descriptions across docs#60
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/04769b11

Conversation

@mintlify
Copy link
Copy Markdown

@mintlify mintlify Bot commented May 19, 2026

Summary

Rewrite description frontmatter on 84 MDX pages (English and Spanish) so each page has a unique, search-friendly summary in the 130–160 character range, and shorten two overlong Spanish OpenAPI titles.

Changes

  • Replaced short or generic descriptions across account/, admin-api/, api-reference/, features/, getting-started/, guides/, platform/, and webhooks/ (and their es/ counterparts) with unique, descriptive summaries of 130–160 characters that include relevant search terms.
  • Resolved 4 cases where unrelated pages shared an identical description (e.g. admin-api/authentication vs api-reference/authentication, and the same pair in es/).
  • Shortened two Spanish OpenAPI page titles that exceeded 60 characters (get-a-single-metric-event-summary-for-a-user.mdx, get-a-users-points-summary.mdx).
  • Left OpenAPI pages without explicit description: frontmatter untouched — descriptions are supplied by the OpenAPI spec.
  • Did not modify page bodies, OpenAPI spec files, or unrelated frontmatter fields (e.g. og:description, subtitle, icon).

Context

Audit triggered to ensure every page has unique, well-sized SEO metadata so titles aren't truncated in search snippets and descriptions aren't replaced by auto-generated text.

@mintlify
Copy link
Copy Markdown
Author

mintlify Bot commented May 19, 2026

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

Project Status Preview Updated (UTC)
trophy 🟢 Ready View Preview May 19, 2026, 12:40 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