Repository navigation
Add per-page SEO tags, llms.txt, Markdown pages, robots.txt and analytics - #151
Merged
Merged
Conversation
…tics
Fills the gaps left by moving off GitBook:
- Each page gets its own meta description (front matter, or its first
paragraph), a canonical URL, and og/twitter title, description and URL.
Five pages with weak opening lines get a hand-written description.
- /llms.txt, /llms-full.txt, and a .md copy of every page, linked from each
page's head as a text/markdown alternate.
- robots.txt allowing all crawlers and pointing at the sitemap.
- Cloudflare Web Analytics (cookieless).
- Fixes 12 links that showed a raw file name ("refund-policy.md") instead of
the page title, which GitBook used to fill in. npm run check now fails on
these.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
![claude[bot]](https://avatars.githubusercontent.com/in/1236702?s=60&v=4){kind=small}
The '^' in the anchor branch came after '<a ...>' in the pattern, so with no m flag it could never match: a link like [#maestro-support-policy](...) passed. Each branch now has to fill the whole link text. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Code reviewNo issues found. Checked for bugs and CLAUDE.md compliance. 🤖 Generated with Claude Code |
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
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.
Follow-up to #150. This fills the SEO and agent features we lost when we moved off GitBook.
What's added
description:front matter, or else from its first paragraph, shortened to about 160 characters. Five pages open with a weak line, such as one that just leads into a list, so they get a hand-written description: Quickstart, Devices & OS Versions, Flows & Workspaces, Runner Types and REST API Results.og:andtwitter:title, description and URL on every page, so shared links show the right title and summary./llms.txt,/llms-full.txt, and a.mdcopy of every page (e.g./cli-reference/cloud.md), as GitBook had. VitePress syntax is turned into standard Markdown: callouts become blockquotes, tabs become bold labels, and links and images become absolute URLs. Each HTML page also links to its Markdown copy with<link rel="alternate" type="text/markdown">.robots.txtallows all crawlers and points at the sitemap. Before this, the file had only Cloudflare's comment header.config.mtsis public by design. Dashboard: Analytics & Logs → Web Analytics.Fixes a regression from #150
GitBook's "mention" links (
[refund-policy.md](refund-policy.md "mention")) show the page title on GitBook. VitePress shows the raw file name, so the live site currently reads "Read about concurrency-and-parallel-runs.md". This fixes all 12 of them, across 4 files.npm run checknow fails on any link whose text is a file name.Testing
npm run buildandnpm run checkpass. I confirmed the new check catches the old links.llms.txt.wrangler dev:.mdis served astext/markdown, andllms.txtandrobots.txtastext/plain.🤖 Generated with Claude Code