Skip to content

Apply SEO and metadata best practices - #6798

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/2abde8c6
Open

Apply SEO and metadata best practices#6798
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/2abde8c6

Conversation

@mintlify

@mintlify mintlify Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Summary

Trimmed page descriptions that exceeded the 160-character SEO limit so they display fully in search snippets.

Changes

  • enterprise-contracting.mdx — description 176 → 148 chars
  • es/deploy/custom-portal.mdx — description 190 → 152 chars
  • es/editor/settings.mdx — description 175 → 144 chars
  • fr/editor/settings.mdx — description 185 → 146 chars

Context

Full frontmatter audit of the 988 MDX files added in this merge. Findings:

  • All API operation-reference pages already inherit their description from the OpenAPI spec — no frontmatter changes needed.
  • assistant/widget-preview.mdx (all languages) has a short description but is noindex: true, so it is excluded from search — left as-is.
  • No duplicate descriptions found within any language.
  • Chinese (zh/) translations were not modified: the 130–160 character range is calibrated for Latin-script SERP width and does not apply to CJK.

Note

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

Overview
Shortens YAML description frontmatter on four MDX pages so snippets stay within the usual ~160-character SEO limit. No body copy, titles, or other metadata change.

English: enterprise-contracting.mdx — tightens wording (drops spelled-out “Master Servicer Agreement (MSA)”) and anchors the summary on purchase and onboarding.

Spanish: es/deploy/custom-portal.mdx — shorter portal/self-host phrasing. es/editor/settings.mdx — same IA/PR/merge topic, more compact Spanish.

French: fr/editor/settings.mdx — parallel trim for the editor settings page.

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

@mintlify

mintlify Bot commented Jul 28, 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 Jul 28, 2026, 11:33 PM

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
tomee 🟢 Ready View Preview Jul 28, 2026, 11: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.

1 participant