Automated SEO fixes: resolve 2 short titles and trim 4 long descriptions - #428
Closed
rachaelrenk wants to merge 1 commit into
Closed
Automated SEO fixes: resolve 2 short titles and trim 4 long descriptions#428rachaelrenk wants to merge 1 commit into
rachaelrenk wants to merge 1 commit into
Conversation
Titles (title_too_short, <20 chars including " | Warp"): - platform/agents.mdx: "Cloud agents" -> "Cloud agents and service accounts". Also removes near-duplication with "Cloud agents overview" (platform/index.mdx). - computer-use/browser-use.mdx: "Browser use" -> "Browser use for agents". Sidebar label stays "Browser use". Descriptions (description_too_long, >160 chars): - platform/runners.mdx: 184 -> 148 - guides/.../run-a-software-factory-in-the-cloud.mdx: 180 -> 148 - guides/.../build-a-self-improving-agent.mdx: 177 -> 142 - enterprise/.../team-managed-keys-and-endpoints.mdx: 168 -> 154 Co-Authored-By: Oz <oz-agent@warp.dev>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
|
Superseded by a bot-authored replacement PR from the same branch. Closing this human-authored draft. |
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
1 participant
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.
Summary
Ran the
docs-seo-auditskill against the live sitemap: 352 pages scanned, 12 issues found (0 errors, 8 warnings, 4 info). This PR fixes the 6 actionable issues. The other 6 are on the skill's intentional-exceptions allowlist.Title fixes (
title_too_short)src/content/docs/platform/agents.mdxCloud agents(19 chars with| Warp)Cloud agents and service accountssrc/content/docs/agent-platform/capabilities/computer-use/browser-use.mdxBrowser use(18 chars)Browser use for agentsNotes:
platform/agents.mdxalso had near-duplicate framing withCloud agents overview(platform/index.mdx). The new title reflects what the page actually covers — cloud agents as team-level identities, agent API keys, and their service-account representation in the CLI and API — and removes the keyword overlap.titlechanged on both pages. Sidebar labels (Agents,Browser use) and URLs are unchanged, so navigation and breadcrumbs stay as-is. Starlight derives the H1 fromtitle, so headings stay in sync automatically.Description fixes (
description_too_long, max 160 chars)src/content/docs/platform/runners.mdxsrc/content/docs/guides/agent-workflows/run-a-software-factory-in-the-cloud.mdxsrc/content/docs/guides/agent-workflows/build-a-self-improving-agent.mdxsrc/content/docs/enterprise/enterprise-features/team-managed-keys-and-endpoints.mdxAll rewrites are grounded in the page content, keep the primary keyword, and follow
AGENTS.mdvoice and terminology. The runners description also drops an em dash in favor of a colon.Not changed (intentional exceptions)
These 6
title_too_shortwarnings match the allowlist in the skill and were left alone:changelog/index.mdx,guides/index.mdx,reference/cli/artifacts.mdx,terminal/windows/tabs.mdx,terminal/windows/tab-configs.mdx,terminal/windows/split-panes.mdx.Validation
npm run buildsucceeds (353 pages).<title>and<meta name="description">tags indist/for all six pages.Conversation: https://app.warp.dev/conversation/9ed250ab-c31f-4ee8-b037-beb7675ede81
Run: https://oz.warp.dev/runs/019fb6f9-241b-7c28-bfe4-1b3f7772d1f9
This PR was generated with Oz.