Skip to content

Apply SEO and metadata best practices - #7161

Closed
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/9d1202d0
Closed

Apply SEO and metadata best practices#7161
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/9d1202d0

Conversation

@mintlify

@mintlify mintlify Bot commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

Summary

Expands under-length meta descriptions found in an SEO audit of all MDX pages so they fall in the 130–160 character range Google favors for snippets.

Changes

  • editor/collaborate.mdx: 104 → 142 chars
  • editor/publish.mdx: 121 → 149 chars
  • editor/review.mdx: 116 → 143 chars
  • migration/manual.mdx: 128 → 139 chars

Context

  • All other English pages pass title/description checks; API reference pages inherit descriptions from their OpenAPI operation references.
  • assistant/widget-preview.mdx is noindex: true, so its short description was left as is.
  • es/, fr/, and zh/ pages are machine-generated translations (gt.config.json regenerates locale dirs), so fixes apply to English sources only.

Note

Low Risk
Documentation metadata only; no runtime, routing, or content changes beyond YAML frontmatter descriptions.

Overview
Updates frontmatter description fields on four English MDX pages so meta descriptions meet the ~130–160 character range targeted by an SEO audit. Page body content is unchanged.

editor/collaborate.mdx, editor/publish.mdx, and editor/review.mdx now spell out Mintlify/web-editor collaboration, publishing, and review workflows in the snippet text. migration/manual.mdx slightly rephrases the migration scope line (“to Mintlify, including …”).

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

@mintlify

mintlify Bot commented Aug 27, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Aug 27, 2026, 10:55 PM

@mintlify

mintlify Bot commented Aug 27, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
tomee 🟡 Building Aug 27, 2026, 10:53 PM

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

@mintlify
mintlify Bot requested a review from ethanpalm August 27, 2026 22:54
Comment thread editor/collaborate.mdx Outdated
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.

1 participant