Skip to content

Apply SEO and metadata best practices#6289

Merged
ethanpalm merged 1 commit into
mainfrom
mintlify/0307829d
Jun 25, 2026
Merged

Apply SEO and metadata best practices#6289
ethanpalm merged 1 commit into
mainfrom
mintlify/0307829d

Conversation

@mintlify

@mintlify mintlify Bot commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

Summary

Tightens Spanish and French frontmatter description values that exceeded the 130–160 character SEO range, and expands one short Spanish description so each page has a unique snippet Google is likely to surface.

Changes

  • Shortened 8 es/ and 8 fr/ descriptions that exceeded 160 characters (over which Google truncates).
  • Rewrote es/deploy/multi-repo.mdx description (123 → 144 chars) to clear the 130-character floor.
  • All updated descriptions stay between 130 and 160 characters and remain unique across the in-scope set.

Context

Audit scope: all MDX docs in the repo. English pages all passed. No missing/duplicate descriptions, no missing titles, no long or boilerplate titles. Chinese (zh/) descriptions flagged as "short" by character count were left untouched because CJK character-length does not map to the Latin 130–160 SEO heuristic.


Note

Low Risk
Metadata-only frontmatter edits on localized docs with no runtime, auth, or deployment logic changes.

Overview
Aligns Spanish and French doc pages with SEO metadata length guidance by editing only frontmatter description values—no page body or navigation changes.

Eight es/ and eight fr/ descriptions that were over ~160 characters are shortened so snippets are less likely to be truncated in search results. es/deploy/multi-repo.mdx is the exception on the short side: its description is lengthened (into the 130–160 band) so it meets the minimum length target.

Wording is tightened in parallel across automations, CLI, credits, GitLab self-hosted OAuth, and automation guides; English and other locales are untouched in this diff.

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

@mintlify

mintlify Bot commented Jun 25, 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 Jun 25, 2026, 11:18 PM

@mintlify mintlify Bot requested a review from ethanpalm June 25, 2026 23:16
@mintlify

mintlify Bot commented Jun 25, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
smartac 🟢 Ready View Preview Jun 25, 2026, 11:19 PM

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

@mintlify

mintlify Bot commented Jun 25, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
testsignup415 🟢 Ready View Preview Jun 25, 2026, 11:18 PM

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

@mintlify

mintlify Bot commented Jun 25, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
adminroletesting 🟢 Ready View Preview Jun 25, 2026, 11:18 PM

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

@mintlify

mintlify Bot commented Jun 25, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
hfh-d7a4d643 🟢 Ready View Preview Jun 25, 2026, 11:19 PM

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

@mintlify

mintlify Bot commented Jun 25, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
gwgwgw 🟢 Ready View Preview Jun 25, 2026, 11:19 PM

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

@mintlify

mintlify Bot commented Jun 25, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
tomee 🟢 Ready View Preview Jun 25, 2026, 11:19 PM

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

@ethanpalm ethanpalm merged commit 3ae9f90 into main Jun 25, 2026
6 checks passed
@ethanpalm ethanpalm deleted the mintlify/0307829d branch June 25, 2026 23:34
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.

2 participants