Skip to content

docs: improve SEO titles and descriptions for SDK reference pages#219

Merged
mintlify[bot] merged 1 commit into
mainfrom
mintlify/dc980af3
May 18, 2026
Merged

docs: improve SEO titles and descriptions for SDK reference pages#219
mintlify[bot] merged 1 commit into
mainfrom
mintlify/dc980af3

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 18, 2026

Summary

Adds descriptive, search-friendly titles and unique descriptions to the 46 TypeDoc-generated SDK reference pages, which previously had boilerplate titles (e.g. Class: AuthenticationError) and no description frontmatter at all.

Changes

  • Replaced boilerplate Class: X / Interface: X / Type Alias: X / client/x titles with specific, descriptive titles under 60 characters.
  • Added a unique description (130–160 chars) to every SDK reference page so each page has a distinct, search-relevant snippet instead of a Google-generated one.
  • Covers all of docs/sdk/reference/**: module index pages, error classes, interceptors, managers, transport, model interfaces, and option type aliases.
  • No page content was changed — only frontmatter.

Context

Audit of all 183 MDX files found that the rest of the docs already have well-formed title and description frontmatter; the only SEO gaps were in the generated SDK reference subtree.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 18, 2026

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

Project Status Preview Updated (UTC)
terminal49 🟢 Ready View Preview May 18, 2026, 12:14 AM

@greptile-apps
Copy link
Copy Markdown

greptile-apps Bot commented May 18, 2026

Target branch is in the excluded branches list.

@vercel
Copy link
Copy Markdown

vercel Bot commented May 18, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
api Building Building Preview, Comment May 18, 2026 0:14am

Request Review

@mintlify mintlify Bot merged commit aad3536 into main May 18, 2026
8 of 10 checks passed
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