Skip to content

Apply SEO and metadata best practices - #7474

Merged
ethanpalm merged 2 commits into
mainfrom
mintlify/90bedf99
Sep 23, 2026
Merged

ethanpalm merged 2 commits into
mainfrom
mintlify/90bedf99

Conversation

@mintlify

@mintlify mintlify Bot commented Sep 23, 2026

Copy link
Copy Markdown
Contributor

Summary

Shorten seven localized descriptions that exceeded 160 characters and one Chinese title that exceeded the halved 30-character threshold for CJK pages.

Changes

  • es/editor/agent.mdx — description was 171c, rewritten to 131c.
  • es/editor/settings.mdx — description was 183c, rewritten to 134c.
  • fr/editor/agent.mdx — description was 218c, rewritten to 134c.
  • fr/editor/pages.mdx — description was 176c, rewritten to 142c.
  • fr/editor/settings.mdx — description was 207c, rewritten to 131c.
  • fr/editor/tutorial.mdx — description was 168c, rewritten to 144c.
  • fr/guides/branches.mdx — description was 177c, rewritten to 142c.
  • zh/ai/model-context-protocol.mdx — title was 32c (over the halved 30c CJK cap), shortened to "Model Context Protocol 服务器" (26c).

Context

Scope resolved from the trigger commit: source-files-only run, so audited MDX pages whose frontmatter changed in the last 30 days (154 in-scope files). All deleted or renamed pages in the same window already have redirects in redirects.json. No duplicate descriptions detected across the repo apart from the assistant/widget-preview.mdx placeholder, which is out of scope.


Note

Low Risk
Metadata-only frontmatter edits with no runtime, auth, or content body changes.

Overview
This PR tightens frontmatter only on eight localized MDX pages so titles and descriptions meet SEO length guidelines (roughly 160 characters for descriptions and a shorter cap for CJK titles).

Spanish and French editor/guide pages get rewritten description fields that stay on-topic but drop extra clauses (for example file upload, suggestions, or long publishing wording on es/editor/agent, fr/editor/settings, and fr/guides/branches).

Chinese MCP docs shorten the title on zh/ai/model-context-protocol.mdx by removing the redundant (MCP) parenthetical so it fits the CJK title limit.

Page bodies and keywords are unchanged; only search/social metadata snippets should differ in SERPs and previews.

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

@mintlify

mintlify Bot commented Sep 23, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated
mintlify 🟢 Ready View Preview Sep 23, 2026, 6:15 PM

@mintlify
mintlify Bot requested a review from ethanpalm September 23, 2026 18:14
@ethanpalm
ethanpalm merged commit 645035b into main Sep 23, 2026
5 checks passed
@ethanpalm
ethanpalm deleted the mintlify/90bedf99 branch September 23, 2026 18:15
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