Automated SEO fixes: resolve title length and description issues across 51 pages (#22)

rachaelrenk · oz-agent · web-flow · commit d5e3826ff98e · 2026-05-05T15:58:58.000-06:00
* Automated SEO fixes: resolve title length and description issues across 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> * fix: sentence case corrections and skill update for casing rules - 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> * fix: remove duplicate sidebar key in skills.mdx frontmatter Co-Authored-By: Oz <oz-agent@warp.dev> --------- Co-authored-by: Oz <oz-agent@warp.dev>
diff --git a/.agents/skills/docs-seo-audit/SKILL.md b/.agents/skills/docs-seo-audit/SKILL.md
@@ -119,6 +119,19 @@ Before making any changes, read these references:
 3. **OG and Twitter tags mirror title and description** automatically. No separate fix needed.
 4. **Changing a sidebar config label has side effects**: it also changes the sidebar label, breadcrumbs, and prev/next pagination. URLs are NOT affected (URLs are based on the file path/slug).
 5. **When changing a title, also update the H1** in the markdown file for consistency.
+6. **All titles, labels, and H1 headings must use sentence case.** Capitalize only the first word and proper nouns. Only recognized proper feature names retain their capitalization — check `AGENTS.md` and `.agents/references/terminology.md` for the canonical list. Common mistakes to avoid:
+   - ✅ `Computer use for agents` — generic term, sentence case
+   - ❌ `Computer Use for Agents` — not a proper feature name, don't capitalize
+   - ✅ `API keys` — generic term, sentence case
+   - ❌ `API Keys` — not a proper feature name
+   - ✅ `Known issues` — generic term, sentence case
+   - ❌ `Known Issues` — not a proper feature name
+   - ✅ `Slack integration` — external product name (Slack) + generic term
+   - ❌ `Slack Integration for Oz` — "Integration" is not a proper feature name; "for Oz" is imprecise (see terminology rules)
+   - ✅ `Agent Mode` — proper feature name, retains capitalization
+   - ✅ `Codebase Context` — proper feature name, retains capitalization
+   - ✅ `Tab Configs` — proper feature name, retains capitalization
+   - ✅ `Warp Drive` — proper feature name, retains capitalization
 
 ### Title exceptions
 
diff --git a/src/content/docs/agent-platform/capabilities/computer-use.mdx b/src/content/docs/agent-platform/capabilities/computer-use.mdx
@@ -1,5 +1,7 @@
 ---
-title: Computer Use
+title: Computer use for agents
+sidebar:
+  label: "Computer use"
 description: >-
   Let agents interact with desktop GUIs in sandboxed cloud environments for
   automated UI testing and validation.
diff --git a/src/content/docs/agent-platform/capabilities/model-choice.mdx b/src/content/docs/agent-platform/capabilities/model-choice.mdx
@@ -1,5 +1,7 @@
 ---
-title: Model choice
+title: Agent model choice
+sidebar:
+  label: "Model choice"
 description: >-
   Choose from a curated set of top LLMs for Warp's Agents (or let Warp
   auto-select the best model).
diff --git a/src/content/docs/agent-platform/capabilities/planning.mdx b/src/content/docs/agent-platform/capabilities/planning.mdx
@@ -1,5 +1,7 @@
 ---
-title: Planning
+title: Agent planning and execution
+sidebar:
+  label: "Planning"
 description: >-
   Turn requests into structured, editable plans that agents execute
   step-by-step with version control.
diff --git a/src/content/docs/agent-platform/capabilities/rules.mdx b/src/content/docs/agent-platform/capabilities/rules.mdx
@@ -1,5 +1,7 @@
 ---
-title: Rules
+title: Rules for agents
+sidebar:
+  label: "Rules"
 description: >-
   Create reusable Global or Project Rules to ensure Warp’s agents follow your
   coding standards, project conventions, and personal preferences.
diff --git a/src/content/docs/agent-platform/capabilities/skills.mdx b/src/content/docs/agent-platform/capabilities/skills.mdx
@@ -1,5 +1,7 @@
 ---
-title: Skills
+title: Skills for agents
+sidebar:
+  label: "Skills"
 description: >-
   Create reusable instruction sets that teach agents specific tasks and share
   expertise across your team.
diff --git a/src/content/docs/agent-platform/capabilities/web-search.mdx b/src/content/docs/agent-platform/capabilities/web-search.mdx
@@ -1,5 +1,7 @@
 ---
-title: Web Search
+title: Agent web search
+sidebar:
+  label: "Web search"
 description: >-
   Warp’s web search lets agents pull in real-time information, documentation,
   and cited sources whenever it improves an answer.
diff --git a/src/content/docs/agent-platform/cli-agents/claude-code.mdx b/src/content/docs/agent-platform/cli-agents/claude-code.mdx
@@ -1,5 +1,7 @@
 ---
-title: Claude Code
+title: Claude Code in Warp
+sidebar:
+  label: "Claude Code"
 description: >-
   Set up Claude Code in Warp with full notification support, rich input, code
   review, and more.
diff --git a/src/content/docs/agent-platform/cli-agents/codex.mdx b/src/content/docs/agent-platform/cli-agents/codex.mdx
@@ -1,5 +1,7 @@
 ---
-title: Codex
+title: Codex CLI in Warp
+sidebar:
+  label: "Codex"
 description: >-
   Set up Codex in Warp with notification support, rich input, code review, and
   more.
diff --git a/src/content/docs/agent-platform/cli-agents/opencode.mdx b/src/content/docs/agent-platform/cli-agents/opencode.mdx
@@ -1,5 +1,7 @@
 ---
-title: OpenCode
+title: OpenCode in Warp
+sidebar:
+  label: "OpenCode"
 description: >-
   Set up OpenCode in Warp with notification support, rich input, code review,
   and more.
diff --git a/src/content/docs/agent-platform/cloud-agents/environments.mdx b/src/content/docs/agent-platform/cloud-agents/environments.mdx
@@ -1,5 +1,7 @@
 ---
-title: Environments
+title: Cloud agent environments
+sidebar:
+  label: "Environments"
 description: >-
   Environments ensure your cloud agents run with consistent toolchains across
   all triggers. Learn when to use environments and how to configure them.
diff --git a/src/content/docs/agent-platform/cloud-agents/integrations/azure-devops.mdx b/src/content/docs/agent-platform/cloud-agents/integrations/azure-devops.mdx
@@ -1,5 +1,7 @@
 ---
-title: Azure DevOps
+title: Azure DevOps integration
+sidebar:
+  label: "Azure DevOps"
 description: >-
   Connect Oz cloud agents to Azure DevOps repos using personal access tokens
   and Warp-managed secrets.
diff --git a/src/content/docs/agent-platform/cloud-agents/integrations/bitbucket.mdx b/src/content/docs/agent-platform/cloud-agents/integrations/bitbucket.mdx
@@ -1,5 +1,7 @@
 ---
-title: Bitbucket
+title: Bitbucket integration
+sidebar:
+  label: "Bitbucket"
 description: >-
   Connect Oz cloud agents to Bitbucket repos using access tokens and
   Warp-managed secrets.
diff --git a/src/content/docs/agent-platform/cloud-agents/integrations/gitlab.mdx b/src/content/docs/agent-platform/cloud-agents/integrations/gitlab.mdx
@@ -1,5 +1,7 @@
 ---
-title: GitLab
+title: GitLab integration
+sidebar:
+  label: "GitLab"
 description: >-
   Connect Oz cloud agents to GitLab repos using personal access tokens and
   Warp-managed secrets.
diff --git a/src/content/docs/agent-platform/cloud-agents/integrations/linear.mdx b/src/content/docs/agent-platform/cloud-agents/integrations/linear.mdx
@@ -1,5 +1,7 @@
 ---
-title: Linear
+title: Linear integration
+sidebar:
+  label: "Linear"
 description: >-
   Automate Linear issues with Oz agents that run code in the cloud and create
   pull requests on your behalf.
diff --git a/src/content/docs/agent-platform/cloud-agents/integrations/slack.mdx b/src/content/docs/agent-platform/cloud-agents/integrations/slack.mdx
@@ -1,5 +1,7 @@
 ---
-title: Slack
+title: Slack integration
+sidebar:
+  label: "Slack"
 description: >-
   Trigger Oz agents from Slack to run cloud tasks, track progress, and create
   pull requests.
diff --git a/src/content/docs/agent-platform/cloud-agents/mcp.mdx b/src/content/docs/agent-platform/cloud-agents/mcp.mdx
@@ -1,5 +1,5 @@
 ---
-title: MCP Servers
+title: MCP Servers for cloud agents
 description: >-
   Connect cloud agents to external tools, APIs, and internal services using
   MCP servers.
diff --git a/src/content/docs/agent-platform/cloud-agents/oz-web-app.mdx b/src/content/docs/agent-platform/cloud-agents/oz-web-app.mdx
@@ -1,5 +1,5 @@
 ---
-title: Oz Web App
+title: Oz Web App for cloud agents
 description: >-
   Use the Oz web app to manage cloud agents, view runs, create schedules, and
   configure environments and integrations from any browser or mobile device.
diff --git a/src/content/docs/agent-platform/cloud-agents/platform.mdx b/src/content/docs/agent-platform/cloud-agents/platform.mdx
@@ -1,5 +1,5 @@
 ---
-title: Oz Platform
+title: Oz Platform overview
 description: >-
   The Oz Platform provides the CLI, API/SDK, orchestration, environments, and
   observability for cloud agents.
diff --git a/src/content/docs/agent-platform/cloud-agents/secrets.mdx b/src/content/docs/agent-platform/cloud-agents/secrets.mdx
@@ -1,5 +1,7 @@
 ---
-title: Secrets
+title: Cloud agent secrets
+sidebar:
+  label: "Secrets"
 description: >-
   Securely store, scope, and inject credentials for Warp cloud agents across
   CLI, Slack, Linear, and scheduled runs—without ever exposing secret values.
diff --git a/src/content/docs/agent-platform/cloud-agents/self-hosting/monitoring.mdx b/src/content/docs/agent-platform/cloud-agents/self-hosting/monitoring.mdx
@@ -1,5 +1,7 @@
 ---
-title: Monitoring
+title: Self-hosted worker monitoring
+sidebar:
+  label: "Monitoring"
 description: >-
   Monitor self-hosted Oz workers with OpenTelemetry metrics. Export to
   Prometheus, OTLP, or console to track worker health, task throughput,
diff --git a/src/content/docs/agent-platform/cloud-agents/self-hosting/unmanaged.mdx b/src/content/docs/agent-platform/cloud-agents/self-hosting/unmanaged.mdx
@@ -1,9 +1,8 @@
 ---
 title: Unmanaged architecture
 description: >-
-  Run Oz agents in your existing CI, Kubernetes, or dev environments using the
-  oz agent run CLI. You orchestrate the runs; Warp provides tracking and
-  observability.
+  Run Oz agents in your existing CI, Kubernetes, or dev environments using
+  the oz agent run CLI with Warp tracking and observability.
 sidebar:
   label: "Unmanaged"
 ---
diff --git a/src/content/docs/agent-platform/getting-started/faqs.mdx b/src/content/docs/agent-platform/getting-started/faqs.mdx
@@ -1,5 +1,7 @@
 ---
-title: Agent FAQs
+title: Agent platform FAQs
+sidebar:
+  label: "Agent FAQs"
 description: >-
   Frequently asked questions about Warp's AI features, including supported
   models, privacy practices, credit limits, billing, and usage guidelines.
diff --git a/src/content/docs/agent-platform/local-agents/code-diffs.mdx b/src/content/docs/agent-platform/local-agents/code-diffs.mdx
@@ -1,5 +1,7 @@
 ---
-title: Code Diffs
+title: Agent code diffs and review
+sidebar:
+  label: "Code diffs"
 description: >-
   How to review, refine, and apply code changes generated by Warp’s Agents
   with the built-in diff editor in Agent Conversations.
diff --git a/src/content/docs/agent-platform/local-agents/interacting-with-agents/voice.mdx b/src/content/docs/agent-platform/local-agents/interacting-with-agents/voice.mdx
@@ -1,5 +1,7 @@
 ---
-title: Voice
+title: Voice input for agents
+sidebar:
+  label: "Voice"
 description: >-
   Voice enables natural language interaction with Warp, letting you speak
   commands and queries directly to your terminal.
diff --git a/src/content/docs/enterprise/getting-started/faq.mdx b/src/content/docs/enterprise/getting-started/faq.mdx
@@ -1,5 +1,7 @@
 ---
-title: FAQ
+title: Enterprise FAQ
+sidebar:
+  label: "FAQ"
 description: >-
   Answers to common questions about Warp Enterprise, including login issues,
   SSO, and getting started.
diff --git a/src/content/docs/enterprise/security-and-compliance/trust-center.mdx b/src/content/docs/enterprise/security-and-compliance/trust-center.mdx
@@ -1,5 +1,7 @@
 ---
-title: Trust Center
+title: Warp Trust Center
+sidebar:
+  label: "Trust Center"
 description: >-
   Access Warp's security documentation, compliance certifications, and
   third-party assessment resources to complete your vendor security review.
diff --git a/src/content/docs/enterprise/support-and-resources/billing.mdx b/src/content/docs/enterprise/support-and-resources/billing.mdx
@@ -1,5 +1,7 @@
 ---
-title: Billing
+title: Enterprise billing
+sidebar:
+  label: "Billing"
 description: >-
   Learn about billing for Warp Enterprise, including credits, cloud agent
   costs, and billing management.
diff --git a/src/content/docs/enterprise/team-management/admin-panel.mdx b/src/content/docs/enterprise/team-management/admin-panel.mdx
@@ -1,5 +1,5 @@
 ---
-title: Admin Panel
+title: Admin Panel for teams
 description: >-
   Centralized management for team administrators to configure Warp settings,
   control agent behavior, and enforce security policies across your
diff --git a/src/content/docs/enterprise/team-management/teams.mdx b/src/content/docs/enterprise/team-management/teams.mdx
@@ -1,5 +1,7 @@
 ---
-title: Teams
+title: Team management in Warp
+sidebar:
+  label: "Teams"
 description: >-
   Create and manage teams in Warp to organize users, share resources, and
   collaborate across your engineering organization.
diff --git a/src/content/docs/getting-started/migrate-to-warp/index.mdx b/src/content/docs/getting-started/migrate-to-warp/index.mdx
@@ -1,9 +1,8 @@
 ---
 title: Migrate to Warp
 description: >-
-  Move your settings and mental model into Warp. Pick the tool you're coming
-  from for step-by-step guidance, settings-import notes, and where to find
-  Warp's equivalents of the features you use today.
+  Move your settings and mental model into Warp. Pick the tool you're
+  coming from for step-by-step guidance and Warp equivalents.
 ---
 
 Warp users come from every kind of terminal, editor, and AI coding tool. This section has a dedicated page for each of the most common sources, with step-by-step migration guidance, notes on what transfers automatically, and a cross-reference for the Warp features that replace what you use today.
diff --git a/src/content/docs/getting-started/migrate-to-warp/migrate-to-warp-from-macos-terminal.mdx b/src/content/docs/getting-started/migrate-to-warp/migrate-to-warp-from-macos-terminal.mdx
@@ -1,9 +1,8 @@
 ---
 title: Migrate to Warp from macOS Terminal
 description: >-
-  Switching to Warp from the default macOS Terminal app? Here's a quick
-  reference for matching your existing setup and discovering what Warp adds
-  beyond the basics.
+  Switch from the default macOS Terminal app to Warp. Match your setup and
+  discover what Warp adds beyond the basics.
 ---
 
 Warp gives Terminal.app users everything they already have — shell, theme, font, prompt — plus split panes, tabs, blocks, and Agent Mode for an AI-assisted workflow. This page walks through both an agent-driven migration and the manual GUI steps.
diff --git a/src/content/docs/getting-started/migrate-to-warp/migrate-to-warp-from-windows-terminal.mdx b/src/content/docs/getting-started/migrate-to-warp/migrate-to-warp-from-windows-terminal.mdx
@@ -1,9 +1,8 @@
 ---
 title: Migrate to Warp from Windows Terminal
 description: >-
-  Switching from Windows Terminal and PowerShell to Warp on Windows? Here's
-  how to reconfigure profiles, shells, fonts, and keybindings, and where to
-  find Warp's equivalents for Windows Terminal features.
+  Switch from Windows Terminal to Warp on Windows. Reconfigure profiles,
+  shells, fonts, keybindings, and find Warp equivalents.
 ---
 
 Warp on Windows covers everything you use Windows Terminal for today — profiles, PowerShell, color schemes, keybindings — with Agent Mode and blocks on top. This page walks through the migration.
diff --git a/src/content/docs/guides/agent-workflows/how-to-run-3-agents-in-parallel-summarize-logs-analyze-pr-modify-ui.mdx b/src/content/docs/guides/agent-workflows/how-to-run-3-agents-in-parallel-summarize-logs-analyze-pr-modify-ui.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How To: Run 3 Agents in Parallel (Summarize Logs + Analyze PR + Modify UI)"
+title: "How To: Run 3 Agents in Parallel"
 description: >-
   Run three agent tasks simultaneously in Warp — modify UI, analyze code
   reviews, and summarize production logs in parallel.
diff --git a/src/content/docs/guides/configuration/how-to-create-project-rules-for-an-existing-project-astro-typescript-tailwind.mdx b/src/content/docs/guides/configuration/how-to-create-project-rules-for-an-existing-project-astro-typescript-tailwind.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How To: Create Project Rules for an Existing Project (Astro + Typescript + Tailwind)"
+title: "How To: Create Project Rules for an Existing Project"
 description: >-
   Create and maintain an AGENTS.md project rules file so coding agents always
   understand your project's setup, commands, architecture, and conventions.
diff --git a/src/content/docs/guides/external-tools/figma-remote-mcp-create-a-website-from-a-figma-file-from-scratch.mdx b/src/content/docs/guides/external-tools/figma-remote-mcp-create-a-website-from-a-figma-file-from-scratch.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Figma Remote MCP: Create a Website from a Figma File from Scratch"
+title: "Figma Remote MCP: Create a Website from a Figma File"
 description: >-
   Connect Warp to Figma's remote MCP server via OAuth and generate front-end
   code directly from your design files.
diff --git a/src/content/docs/guides/frontend/how-to-actually-code-ui-that-matches-your-mockup-react-tailwind.mdx b/src/content/docs/guides/frontend/how-to-actually-code-ui-that-matches-your-mockup-react-tailwind.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How To: Actually Code UI That Matches Your Mockup (React + Tailwind)"
+title: "How To: Code UI That Matches Your Mockup"
 description: >-
   Prompt Warp to generate pixel-perfect React + Tailwind code from design
   mockups, with structured specs and iterative refinement.
diff --git a/src/content/docs/reference/api-and-sdk/index.mdx b/src/content/docs/reference/api-and-sdk/index.mdx
@@ -1,5 +1,7 @@
 ---
-title: "Oz API & SDK"
+title: "Oz API & SDK reference"
+sidebar:
+  label: "Oz API & SDK"
 description: >-
   Create and inspect cloud agent runs over HTTP with the Oz API, or use the
   Python and TypeScript SDKs for typed requests, retries, and error handling.
diff --git a/src/content/docs/reference/api-and-sdk/troubleshooting/errors/conflict.mdx b/src/content/docs/reference/api-and-sdk/troubleshooting/errors/conflict.mdx
@@ -1,5 +1,7 @@
 ---
-title: conflict
+title: "Error: conflict (409)"
+sidebar:
+  label: "conflict"
 description: >-
   The request conflicts with the current state of the resource. Wait for the
   resource to reach the expected state and retry.
diff --git a/src/content/docs/reference/cli/api-keys.mdx b/src/content/docs/reference/cli/api-keys.mdx
@@ -1,9 +1,9 @@
 ---
-title: API keys
+title: API keys for the Oz CLI
 description: >-
   Create and manage API keys for authenticating the Oz CLI and cloud agents.
 sidebar:
-  label: "API Keys"
+  label: "API keys"
 ---
 
 API keys let the Oz CLI and cloud agents authenticate without human interaction. Use API keys for CI pipelines, headless servers, VMs, Codespaces, containers, and other automated environments.
diff --git a/src/content/docs/reference/cli/index.mdx b/src/content/docs/reference/cli/index.mdx
@@ -1,5 +1,7 @@
 ---
-title: Oz CLI
+title: Oz CLI reference
+sidebar:
+  label: "Oz CLI"
 description: >-
   Use the Oz CLI to run, configure, and manage agents from the terminal.
 ---
diff --git a/src/content/docs/reference/cli/mcp-servers.mdx b/src/content/docs/reference/cli/mcp-servers.mdx
@@ -1,10 +1,10 @@
 ---
-title: MCP servers
+title: MCP servers (CLI reference)
 description: >-
   Connect agents to external tools like GitHub, Linear, and Sentry by passing
   MCP servers to the --mcp flag as a UUID, inline JSON, or file path.
 sidebar:
-  label: "MCP Servers"
+  label: "MCP servers"
 ---
 
 MCP servers connect agents to external systems like GitHub, Linear, or Sentry. To use a [Model Context Protocol (MCP)](/agent-platform/capabilities/mcp/) server from the CLI, use the `--mcp` flag with `oz agent run` or `oz agent run-cloud`.
diff --git a/src/content/docs/reference/cli/skills.mdx b/src/content/docs/reference/cli/skills.mdx
diff --git a/src/content/docs/support-and-community/community/contributing.mdx b/src/content/docs/support-and-community/community/contributing.mdx
diff --git a/src/content/docs/support-and-community/community/warp-preview-and-alpha-program.mdx b/src/content/docs/support-and-community/community/warp-preview-and-alpha-program.mdx
diff --git a/src/content/docs/support-and-community/plans-and-billing/credits.mdx b/src/content/docs/support-and-community/plans-and-billing/credits.mdx
diff --git a/src/content/docs/support-and-community/plans-and-billing/pricing-faqs.mdx b/src/content/docs/support-and-community/plans-and-billing/pricing-faqs.mdx
diff --git a/src/content/docs/support-and-community/privacy-and-security/network-log.mdx b/src/content/docs/support-and-community/privacy-and-security/network-log.mdx
diff --git a/src/content/docs/support-and-community/privacy-and-security/privacy.mdx b/src/content/docs/support-and-community/privacy-and-security/privacy.mdx
diff --git a/src/content/docs/support-and-community/privacy-and-security/secret-redaction.mdx b/src/content/docs/support-and-community/privacy-and-security/secret-redaction.mdx
diff --git a/src/content/docs/support-and-community/troubleshooting-and-support/known-issues.mdx b/src/content/docs/support-and-community/troubleshooting-and-support/known-issues.mdx
diff --git a/src/content/docs/terminal/input/universal-input.mdx b/src/content/docs/terminal/input/universal-input.mdx
