Repository navigation
Add meta descriptions to the app guides, deep dive, LiteFS and MCP pages - #2580
Open
alexleventer wants to merge 2 commits into
Open
alexleventer wants to merge 2 commits into
alexleventer wants to merge 2 commits into
Conversation
Add a description: to the 64 app guide, deep dive, LiteFS and MCP pages that have none, so Mintlify emits a meta description instead of leaving Google to write its own snippet. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
Each of them imports snippets/obsolete-doc.mdx, which tells readers "This document is old! It is likely wrong in some important way." They are the 18 pages in docs-tracking#364, whose last line says they are skipped for meta descriptions until that decision is made. Half the descriptions said so and half read as current, so merging as-is would have published polished snippets for pages we have decided not to drive traffic to. They get descriptions, noindex or a redirect once #364 lands. 46 pages left in the batch.
kcmartin
approved these changes
Oct 20, 2026
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds
description:to the 64 app guide, deep dive, LiteFS and MCP pages that have none. Mintlify only emits<meta name="description">fromdescription:, so these pages ship without one, and Search Console shows Google writing its own snippets for them. The Ahrefs audit on 2026-10-13 flagged 753 indexable pages without descriptions across fly.io properties.Each description is written from that page's content: 120–155 characters, naming the commands, config and concepts the page actually covers, with no two alike. Pages that warn they're outdated or sunset say so. Only frontmatter changes. Every file still parses with
yaml.safe_load, and no description is over 155 characters.Covers app-guides (24), litefs (19), deep-dive (13) and model-context-protocol (8). The three LiteFS Cloud pages say the service was retired, and the legacy app guides that carry the 'This document is old' warning say they're old.
🤖 Generated with Claude Code
Update, 20 Oct. Dropped the 18 obsolete app guides, so this is 46 pages rather than 64.
Each of them imports
snippets/obsolete-doc.mdx, which tells readers "This document is old! It is likely wrong in some important way." They are exactly the 18 pages in https://github.com/superfly/docs-tracking/issues/364, whose last line says they are skipped for meta descriptions until that decision is made. Half the descriptions said the page was old and half read as current, so merging as-is would have published polished snippets for pages we have decided not to drive traffic to. They get descriptions,noindexor a redirect once #364 lands.Checked across the remaining 46: all are 141 to 155 characters, none duplicated, no prices, no
noindexpages, "Fly.io" at most once. Numeric claims verified against their pages, including the 1GB Livebook volume andshared-cpu-2x, MinIO's 3-node cluster, the L40S GPU, LiteFS Cloud's October 2024 retirement andv0.5.0, the 30-day restore window, port 20202, and the 100 tx/sec FUSE figure.One page left for a decision:
app-guides/planetscaleimportssnippets/v2-needs-update.mdx, a softer warning saying the page hasn't been updated for Machines and "some features don't work the same way anymore". Its description reads as fully current. Keeping it seems reasonable, since that is not the same as "likely wrong", but it is the one page here with a warning on it.