Skip to content

docs: improve SEO descriptions across English docs pages#68

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

docs: improve SEO descriptions across English docs pages#68
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/0412bcbb

Conversation

@mintlify
Copy link
Copy Markdown

@mintlify mintlify Bot commented May 23, 2026

Summary

Rewrites short, duplicate, and generic description frontmatter across 41 English docs pages so each page has a unique 130–160 character description that summarizes what it covers.

Changes

  • Replaced short descriptions (under 130 chars) on pages across account/, admin-api/, api-reference/, features/, getting-started/, guides/, platform/, uikit/, and webhooks/.
  • De-duplicated descriptions that were shared between admin-api/ and api-reference/ pages (authentication, client libraries, rate limiting) so each page has unique copy.
  • Added a missing description to uikit/overview.mdx.
  • Left og:description, subtitle, and titles untouched.
  • Did not add descriptions to OpenAPI operation-reference pages — every operation in openapi/admin.yml and openapi/application.yml already defines a description, so the spec supplies them.
  • Spanish pages under es/ are auto-generated by the translation workflow and will be regenerated on merge.

Context

Audit checked all 293 MDX files for missing/empty titles, titles over 60 chars, generic boilerplate titles, missing/empty descriptions, descriptions under 130 chars or over 160 chars, and duplicate descriptions, while honoring OpenAPI operation-ref pages per the prompt.

@mintlify
Copy link
Copy Markdown
Author

mintlify Bot commented May 23, 2026

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

Project Status Preview Updated (UTC)
trophy 🟢 Ready View Preview May 23, 2026, 8:45 AM

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