Skip to content

Give pages that share a title a unique one - #2522

Merged
alexleventer merged 1 commit into
mainfrom
docs-unique-titles
Oct 6, 2026
Merged

alexleventer merged 1 commit into
mainfrom
docs-unique-titles

Conversation

@alexleventer

Copy link
Copy Markdown
Contributor

27 pages had a title that another page also used, so Google saw several pages called "The Basics - Fly.io", "Advanced guides - Fly.io" or "Getting Started - Fly.io" and couldn't tell them apart.

Each of these pages now has a title that names its section, such as "Rails: The Basics" or "Unmanaged Postgres: Getting Started". The H1 changes with it. sidebarTitle keeps the old label, so the navigation doesn't change.

  • The Basics ×6, Advanced guides ×5, Getting Started ×4: the framework or section is now in the title.
  • SQLite3, Multiple Fly Applications, Volumes, Migrate from Heroku: the framework is now in the title.
  • MCP pages "fly launch", "fly mcp launch" and "Machines API" had the same titles as the flyctl and API reference pages. They're now titled as the guides they are ("Deploy an MCP Server with fly launch"). The generated flyctl/cmd/ pages are untouched.
  • "PostgreSQL" ×2 → "Deep Dive: PostgreSQL" and "Prisma with PostgreSQL". "Guides and Examples" ×2 → "Machines Guides and Examples" for the Machines one.

I checked this with mint dev: /rails/the-basics renders <title>Rails: The Basics - Fly.io</title> and the sidebar still says "The Basics". After this change, no two pages in the repo share a title.

🤖 Generated with Claude Code

27 pages had a title another page also used, most of them framework
section indexes ("The Basics", "Advanced guides", "Getting Started").
Each title now names its section, and sidebarTitle keeps the old label
so the navigation reads the same.

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

mintlify Bot commented Oct 1, 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 1, 2026, 5:01 AM

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

@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!

@alexleventer
alexleventer merged commit 1cf7488 into main Oct 6, 2026
2 checks passed
@alexleventer
alexleventer deleted the docs-unique-titles branch October 6, 2026 00:20

This branch was successfully deployed

1 active deployment
staging — 5b554c84 Deployed Oct 1, 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