Automated SEO fixes: resolve title length and description issues across 51 pages#22
Merged
rachaelrenk merged 3 commits intomainfrom May 5, 2026
Merged
Conversation
…ss 51 pages - Fix 40 title_too_short warnings by adding descriptive frontmatter titles with sidebar.label to preserve nav labels - Fix 4 title_too_long warnings by shortening guide titles - Fix 7 description_too_long info issues by trimming descriptions to ≤160 chars - Skip 5 allowlisted pages (Changelog, Guides, Tabs, Split panes, Tab Configs) - Skip 1 unfixable page (https://docs.warp.dev/api/ - no source file) Co-Authored-By: Oz <oz-agent@warp.dev>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
- Fix title case → sentence case in titles and sidebar labels: computer-use, web-search, api-keys, mcp-servers, network-log, known-issues - Simplify integration titles: remove 'for Oz' suffix (azure-devops, bitbucket, gitlab, linear, slack) - Add key principle #6 to SEO audit skill with explicit sentence case rule and ✅/❌ examples to prevent future casing mistakes Co-Authored-By: Oz <oz-agent@warp.dev>
Co-Authored-By: Oz <oz-agent@warp.dev>
hongyi-chen
approved these changes
May 5, 2026
Collaborator
hongyi-chen
left a comment
hongyi-chen
left a comment
There was a problem hiding this comment.
This all looks good to me. It's great that we can customize what it looks on the sidebar, while changing the top-level title for SEO.
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.
Summary
Automated SEO audit of docs.warp.dev (308 pages scanned, 57 issues found). This PR fixes 51 issues across title length and description length categories.
Fixed (51 issues)
Title too short (40 pages):
Added descriptive
titlefrontmatter fields withsidebar.labelto preserve short nav labels. Examples:Title too long (4 pages):
Shortened guide titles to ≤70 chars (including " | Warp" suffix). Examples:
Description too long (7 pages):
Trimmed descriptions to ≤160 chars for pages in migrate-to-warp, contributing, secret-redaction, universal-input, and self-hosting/unmanaged.
Review corrections
The following issues were caught during human review and fixed in a follow-up commit:
Sentence case fixes (11 pages):
Computer Use for agents→Computer use for agents(computer-use.mdx)Agent Web Search→Agent web search(web-search.mdx)API Keys→API keys(api-keys.mdx sidebar label)MCP Servers→MCP servers(mcp-servers.mdx sidebar label)Network Log→Network log(network-log.mdx title and sidebar label)Known Issues→Known issues(known-issues.mdx sidebar label)Skill update:
Allowlisted (5 pages — intentionally short titles)
Changelog, Guides, Tabs, Split panes, Tab Configs
Unfixable (1 page)
https://docs.warp.dev/api/— missing H1, no local source file (auto-generated API reference)Conversation: https://app.warp.dev/conversation/85bb444b-817e-41c9-839c-d8816e3cba87
Run: https://oz.warp.dev/runs/019df943-8d1f-7de7-9a33-283194df3d62
This PR was generated with Oz.