Skip to content

Retitle framework guides for deploy searches - #2548

Merged
kcmartin merged 3 commits into
mainfrom
docs-deploy-titles
Oct 13, 2026
Merged

kcmartin merged 3 commits into
mainfrom
docs-deploy-titles

Conversation

@alexleventer

Copy link
Copy Markdown
Contributor

The framework guides were titled "Run a X App" (or just "Getting Started" for Django, Rails and Elixir) since 2023. People search "deploy X", "X deployment" and "X hosting".

  • Titles/H1s → "Deploy a X App" on 29 pages: the "Run a…" framework guides plus the Django, Rails and Elixir getting-started and existing-app pages. sidebarTitle keeps the current nav labels where they differ.
  • Meta descriptions: og:description doesn't render <meta name="description"> on Mintlify, so these pages had none (the old site used one generic description everywhere). Replaced with description:.
  • Removed the shared opener ("Getting an application running on Fly.io is essentially…") that 21 pages started with.
  • Index pages use the new titles; fixed the Warp "f you don't" typo.

Biggest search targets (US/mo): django hosting 400, django deployment 100, nuxt deployment 200, deploy nextjs app 150, next js deployment 100, deploy streamlit app 70, fastapi deployment 40.

No new broken links (mint broken-links output identical before and after).

🤖 Generated with Claude Code

The framework guides were titled "Run a X App" (or just "Getting Started"
for Django, Rails and Elixir) since 2023, but people search "deploy X",
"X deployment" and "X hosting". Next.js, Nuxt, Django, Flask, FastAPI and
Streamlit each have 20-200 US searches a month on those terms, and we sit
at positions 10-55 or not at all.

- Titles (and so H1s) now say "Deploy", 29 pages
- sidebarTitle keeps the existing labels for the Getting Started and
  Existing App pages
- og:description renders no meta description on Mintlify, so these pages
  had none; replaced with description: written for search
- Dropped the identical "Getting an application running on Fly.io is
  essentially..." opener shared by 21 pages
- Framework index pages link with the new titles
- Fix "f you don't" typo on the Warp page

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@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 13, 2026, 5:31 PM

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

The six Rust guides shared one description sentence; each now names
what's specific to its framework. WordPress was 118 characters.

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

@kcmartin kcmartin left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pushed d98f513 with the index link updates. Please merge after #2551 so the new descriptions do not show as subtitles.

@kcmartin kcmartin left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, Merge after #2551

@kcmartin
kcmartin merged commit e853103 into main Oct 13, 2026
1 check passed
@kcmartin
kcmartin deleted the docs-deploy-titles branch October 13, 2026 20:50

This branch was successfully deployed

1 active deployment
staging — d98f513e Deployed Oct 13, 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.

2 participants