Skip to content

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

Open
alexleventer wants to merge 1 commit into
mainfrom
docs-unique-titles
Open

alexleventer wants to merge 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.

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.

1 participant