Skip to content

Add SEO frontmatter descriptions to MDX pages#2588

Closed
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/seo-descriptions-1777594747
Closed

Add SEO frontmatter descriptions to MDX pages#2588
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/seo-descriptions-1777594747

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 1, 2026

Summary

Audited all MDX pages for missing, short (under 50 characters), and long (over 160 characters) description frontmatter values, then added or rewrote descriptions on 261 hand-written pages so every one has a unique 50–160 character summary suitable for search engines and link previews.

What changed

  • 3 long descriptions shortened to fit under 160 characters: models/runs/delete-runs.mdx, platform/hosting/managing-bucket-storage.mdx, platform/hosting/monitoring-usage/mobile-app.mdx.
  • 2 short hand-written descriptions expanded: sandboxes/create-sandbox.mdx, sandboxes/secrets.mdx.
  • Descriptions added to top-level pages (blog.mdx, courses.mdx, pricing.mdx, security.mdx, support.mdx, sandboxes.mdx), product redirect pages (product-*.mdx), ref-link-*.mdx redirect wrappers, and the support/{models,inference,weave} redirect pages.
  • Descriptions added to all 19 platform/launch FAQ and library pages.
  • Descriptions added to all 7 support/inference/articles/, all 16 support/weave/articles/, and all 189 support/models/articles/ knowledge-base pages.
  • A handful of long FAQ titles that used multi-line YAML continuation were collapsed onto a single quoted line as part of adding the description.

Results

The audit went from 434 OK / 446 missing / 39 short / 3 long to 695 OK / 0 long / 0 short on hand-written pages. The remaining "missing" pages are all auto-generated reference docs (W&B Python SDK, CLI, query panel, Weave Python and TypeScript SDKs, KB tag indexes) and were intentionally excluded so the next generator run does not overwrite the new descriptions.

What was not changed

  • Page bodies are untouched. Only frontmatter description (and a few collapsed multi-line title: fields needed to keep YAML valid).
  • Auto-generated reference pages and template-generated KB index/tag pages.

Validation

  • mint validate — passes.
  • mint broken-links — no broken links.

Add or rewrite the description frontmatter for 261 hand-written documentation pages so each one has a unique 50-160 character summary suitable for search engines and link previews. Auto-generated reference pages (CLI, Python and TypeScript SDKs, query panel, support tag indexes) are intentionally excluded so the next generator run does not overwrite the new descriptions.

Generated-By: mintlify-agent
@mintlify mintlify Bot requested a review from a team as a code owner May 1, 2026 00:27
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 1, 2026

Knowledgebase navigation update

  • Tag pages modified: 46 pages.
  • Product index pages updated: 1 page.
  • Root support.mdx updated.

From workflow run 25196171108

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 1, 2026

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

Project Status Preview Updated (UTC)
wandb 🟢 Ready View Preview May 1, 2026, 12:35 AM

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 1, 2026

📚 Mintlify Preview Links

🔗 View Full Preview

📝 Changed (308 total)

📄 Pages (308)

File Preview
blog.mdx Blog
courses.mdx Courses
inference/ref-link-api.mdx Ref Link Api
inference/support-inference.mdx Support Inference
models/artifacts/artifacts-walkthrough.mdx Artifacts Walkthrough
models/ref-link-cli.mdx Ref Link Cli
models/ref-link-public-api.mdx Ref Link Public Api
models/ref-link-python.mdx Ref Link Python
models/ref-link-query-panel.mdx Ref Link Query Panel
models/ref-link-workspaces.mdx Ref Link Workspaces
... and 298 more files

🤖 Generated automatically when Mintlify deployment succeeds
📍 Deployment: cd4e188 at 2026-05-01 00:36:03 UTC

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 1, 2026

🔗 Link Checker Results

All links are valid!

No broken links were detected.

Checked against: https://wb-21fd5541-mintlify-seo-descriptions-1777594747.mintlify.app

@johndmulhausen
Copy link
Copy Markdown
Contributor

Lets do this next month, maybe

@johndmulhausen johndmulhausen deleted the mintlify/seo-descriptions-1777594747 branch May 6, 2026 16:38
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