Skip to content

Apply SEO and metadata best practices - #7081

Open
mintlify[bot] wants to merge 7 commits into
mainfrom
mintlify/e12634fd
Open

Apply SEO and metadata best practices#7081
mintlify[bot] wants to merge 7 commits into
mainfrom
mintlify/e12634fd

Conversation

@mintlify

@mintlify mintlify Bot commented Aug 25, 2026

Copy link
Copy Markdown
Contributor

Summary

SEO metadata audit of pages touched by recent commits: the POC onboarding page, its translations, and recently updated Chinese pages.

Changes

  • poc-onboarding.mdx: replaced the generic title "POC onboarding" with "Set up and evaluate your Mintlify proof of concept" (51 chars).
  • es/poc-onboarding.mdx: replaced the generic title "Onboarding de POC" with "Configura y evalúa tu prueba de concepto de Mintlify" (52 chars).
  • fr/poc-onboarding.mdx: replaced the generic title "Onboarding POC" with "Configurez et évaluez votre preuve de concept Mintlify" (54 chars).
  • zh/poc-onboarding.mdx: replaced the generic title "POC 入门指南" with a descriptive one and expanded the short description.
  • Expanded too-short descriptions (under 130 chars) into unique 130-155 char summaries on eight Chinese pages: zh/create/list-table.mdx, zh/customize/custom-scripts.mdx, zh/editor/agent.mdx, zh/editor/comments.mdx, zh/search-index/mcp.mdx, zh/ai/llmstxt.mdx, zh/ai/mintlify-mcp.mdx, and zh/deploy/reverse-proxy.mdx.
  • All other pages in scope (English, Spanish, and French counterparts) already met the title and description criteria and were left unchanged.

Note

Low Risk
Documentation metadata only; no runtime, auth, or application logic changes.

Overview
Updates frontmatter only (page title and description) to match Mintlify SEO guidance—descriptive titles and ~130–155 character unique descriptions—without changing page body content.

POC onboarding (en, es, fr, zh): Replaces short generic titles (e.g. “POC onboarding”) with action-oriented titles that spell out setting up and evaluating a Mintlify proof of concept. Chinese POC also gets a longer enterprise-focused description covering repo connect, migration, publish, branding, AI, and security review.

Eight Chinese docs: Expands previously too-short description fields on AI (llmstxt, mintlify-mcp), authoring (list-table, custom-scripts), editor (agent, comments), deploy (reverse-proxy), and search-index (mcp) so each summary is more specific and keyword-rich for search and llms.txt indexing.

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

@mintlify

mintlify Bot commented Aug 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 Aug 25, 2026, 4:36 PM

@mintlify

mintlify Bot commented Aug 25, 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 25, 2026, 4:34 PM

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

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