Skip to content

Add meta descriptions to the top 25 organic landing pages - #2557

Merged
kcmartin merged 2 commits into
mainfrom
meta-descriptions-top-1-25
Oct 15, 2026
Merged

kcmartin merged 2 commits into
mainfrom
meta-descriptions-top-1-25

Conversation

@kcmartin

Copy link
Copy Markdown
Contributor

Adds description: to the organic landing pages ranked 1 to 25 by entrances (3-month export) that had none, so Mintlify emits a meta description instead of letting Google write the snippet. One added line per file. No prices or limits are quoted, since those change.

Merge after #2551 so the descriptions don't show as subtitles.

Part of https://github.com/superfly/docs-tracking/issues/352

These pages had no description:, so Mintlify emitted no meta description
and search engines wrote their own snippet.

Part of superfly/docs-tracking#352
@mintlify

mintlify Bot commented Oct 13, 2026 •

Copy link
Copy Markdown

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

Project Status Preview Updated
fly-io 🟢 Ready View Preview Oct 15, 2026, 5:46 PM

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

@kcmartin
kcmartin merged commit 248ee5c into main Oct 15, 2026
1 check passed
@kcmartin
kcmartin deleted the meta-descriptions-top-1-25 branch October 15, 2026 17:47
kcmartin added a commit that referenced this pull request Oct 15, 2026
* Retitle blueprints for search and add meta descriptions

30 of the 37 blueprints had no meta description, so Google wrote its own
snippet, and many titles were internal names ("Rollback Guide",
"Resilient apps use multiple Machines") rather than what people search.
Over the last 90 days the blueprints drew ~262k impressions but under
1% CTR, with several pages ranking top 10 at 0.1-0.3% CTR.

Titles now lead with the searched term (HIPAA, zero-downtime deployments,
sticky sessions, staging environment, work queues, n-tier architecture,
roll back a deploy). sidebarTitle keeps the existing nav labels.

The six blueprints already covered by #2557 and #2558 are left alone.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Adjust blueprint titles after review

Drop "on Fly.io" (Mintlify already appends " - Fly.io"), soften the
HIPAA title, broaden the autoscale title, keep the original
long-running tasks title, and match the blueprints index to the new
titles.

* Drop sidebarTitle so the sidebar matches the new titles

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: Kristin Martin <kristin@fly.io>

This branch was successfully deployed

1 active deployment
staging — f3d227a7 Deployed Oct 15, 2026 by mintlify[bot]
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