Skip to content

SEO & metadata audit: fix descriptions on 73 pages - #491

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/seo-metadata-audit-2026-10-26
Open

mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/seo-metadata-audit-2026-10-26

Conversation

@mintlify

@mintlify mintlify Bot commented Oct 26, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Added or rewrote frontmatter descriptions so every page in scope has a unique description of 130-160 characters.

Changes

  • Added descriptions to 59 SDK reference pages (interfaces, classes, type aliases) that had none.
  • Replaced the identical description shared by the rail carrier, shipping line, and terminal coverage reference pages.
  • Lengthened short descriptions (inland rail terminals, Antigravity, Gemini setup, two API reference pages) and trimmed descriptions over 160 characters (five API reference pages, SDK models index).
  • Frontmatter only. Titles were all under 60 characters. SDK Interface:/Type Alias: titles were kept to match the generated reference convention.

View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need.

@mintlify

mintlify Bot commented Oct 26, 2026 •

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated
terminal49 🟢 Ready View Preview Oct 26, 2026, 12:10 AM

@greptile-apps

greptile-apps Bot commented Oct 26, 2026

Copy link
Copy Markdown

PR author is in the excluded authors list.

@vercel

vercel Bot commented Oct 26, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
api Ready Ready Preview Oct 26, 2026 12:09am UTC

Request Review

@github-actions github-actions Bot added the risk-shadow:high Shadow-only risk signal: high label Oct 26, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Shadow risk calibration

Signal Result Authority
Path classifier risk:medium Deterministic advisory policy
heuristic fallback risk-shadow:high Shadow only

Calibration result: disagreement (medium vs high).

Shadow risk never blocks or enables merge. Keep it in observation mode until roughly 50 pull requests have human-reviewed labels, then calibrate before considering any policy use.

@github-actions github-actions Bot added risk:unknown Advisory evidence unavailable or changed; no merge permission risk:medium Advisory path risk; current-head human review needed and removed risk:unknown Advisory evidence unavailable or changed; no merge permission labels Oct 26, 2026

This branch was successfully deployed

2 active deployments
staging - docs — 2694770e Deployed Oct 26, 2026 by mintlify[bot]
Preview — 2694770e Deployed Oct 26, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

risk:medium Advisory path risk; current-head human review needed risk-shadow:high Shadow-only risk signal: high

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants