docs: expand short meta descriptions and titles for SEO/GEO#11
Conversation
Several docs pages and the blog index had meta descriptions well under the recommended length, which weakens search snippets and click-through. Rewrite the `description` frontmatter for the flagged v8 and v7.1.1 docs pages, plus the /blog index metadata, to 150-160 characters while keeping each description accurate to the page's content. The bare /docs/<slug> and /docs/8.0.0/<slug> URLs inherit these descriptions via the existing version routing, so updating the source files covers all flagged URLs. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016qs1yzCwULC17LyH4mj9AJ
|
Warning Review limit reached
More reviews will be available in 10 minutes and 30 seconds. Learn how PR review limits work. Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file). ⌛ How to resolve this issue?After more reviews become available, a review can be triggered using the To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits. 🚦 How do rate limits work?CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability. For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window. Please see our Fair Usage Limits Policy for further information. ℹ️ Review info⚙️ Run configurationConfiguration used: Organization UI Review profile: CHILL Plan: Pro Plus Run ID: 📒 Files selected for processing (30)
✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request updates the metadata and frontmatter descriptions across various documentation files and the blog page to provide more detailed, descriptive, and comprehensive summaries of Agent Relay's features, such as multi-agent systems, orchestration, and messaging. I have no feedback to provide as there are no review comments.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
|
Preview deployed!
This is a Cloudflare Workers preview version of this PR's build. |
The flagged pages also had short meta titles. Since the `title` frontmatter doubles as the visible H1 (and nav uses its own labels), lengthening it directly would bloat page headings. Introduce an optional `metaTitle` frontmatter field that feeds only the page metadata (document title, OpenGraph, Twitter), falling back to the existing title when absent. Populate it for the same set of docs pages so their `<title>` tags land at ~50-58 characters with the " | Agent Relay" suffix, and give the /blog index an absolute, descriptive title. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016qs1yzCwULC17LyH4mj9AJ
willwashburn
changed the title
2 participants
Summary
Bing Webmaster Tools flagged a set of pages whose meta descriptions were too short to provide useful search snippets, hurting click-through and SEO/GEO visibility. This PR rewrites the
descriptionfrontmatter for each flagged page to 150–160 characters, while keeping every description accurate to the page's actual content.What changed
description:frontmatter in their source MDX files./blogindex — lengthened thedescriptioninweb/app/blog/page.tsxmetadata.URL → source mapping
The flagged CSV included both bare
/docs/<slug>and versioned URLs. Per the version routing inlib/docs-versions.ts:/docs/8.0.0/<slug>aliases the same v8 files./docs/7.1.1/<slug>and inherit that file's description.So each flagged URL was traced back to a single source file. Duplicate URLs (e.g.
/docs/dms+/docs/8.0.0/dms,/docs/workforce+/docs/7.1.1/workforce) are all covered by one edit.quickstart,dms,cli-overview,reference-cli,sending-messages,agent-relay-mcp/docs/8.0.0/*URLscloud,reference-openclaw,typescript-examples,relay-dashboard,python-sdk,scheduling,workforce,file-sharing,harness-runtime-config,observer,permissions,swift-sdk,authentication,communicate,communicate-claude-sdk,communicate-google-adk,communicate-openai-agents,communicate-ai-sdk,communicate-pi,spawning-an-agent/docs/7.1.1/*URLsweb/app/blog/page.tsx/blogVerification
🤖 Generated with Claude Code
Generated by Claude Code
Summary by cubic
Expanded meta descriptions to 150–160 characters and added optional SEO meta titles across docs and the
/blogindex to improve search snippets and click-through.metaTitleis used in page metadata only, so H1s stay clean.metaTitlefrontmatter inweb/lib/docs.ts; populated across the same docs pages.metaTitleinweb/app/docs/[slug]/page.tsxandweb/app/docs/7.1.1/[slug]/page.tsx(also for OpenGraph/Twitter), falling back totitle.descriptionfrontmatter on 26 docs pages and updated/blogwith an absolute, descriptive title and longer description./docsURLs.Written for commit e5b915c. Summary will update on new commits.