Skip to content

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

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

mintlify[bot] wants to merge 3 commits 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 Nov 9, 2026, 1:06 AM

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

@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 Nov 9, 2026 1:06am 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 risk:medium Advisory path risk; current-head human review needed labels Oct 26, 2026
@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:medium Advisory path risk; current-head human review needed risk:unknown Advisory evidence unavailable or changed; no merge permission labels Nov 2, 2026
@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:medium Advisory path risk; current-head human review needed risk:unknown Advisory evidence unavailable or changed; no merge permission labels Nov 6, 2026
The coverage MDX files are generated by tools/generate-coverage.mjs, so the
new descriptions must come from the generator or the drift check fails.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01V8cPhktNpguVMk39bAstza
@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:medium Advisory path risk; current-head human review needed risk:unknown Advisory evidence unavailable or changed; no merge permission labels Nov 12, 2026

This branch was successfully deployed

2 active deployments
Preview — 3c66ecb4 Deployed Nov 9, 2026 by vercel[bot]
staging - docs — 3c66ecb4 Deployed Nov 9, 2026 by mintlify[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.

1 participant