From 20997c0c62b27ef179c7766c3e42861a97539851 Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk Date: Tue, 5 May 2026 17:56:16 +0000 Subject: [PATCH 1/3] Automated SEO fixes: resolve title length and description issues across 51 pages MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- .../docs/agent-platform/capabilities/computer-use.mdx | 4 +++- .../docs/agent-platform/capabilities/model-choice.mdx | 4 +++- src/content/docs/agent-platform/capabilities/planning.mdx | 4 +++- src/content/docs/agent-platform/capabilities/rules.mdx | 4 +++- src/content/docs/agent-platform/capabilities/skills.mdx | 4 +++- src/content/docs/agent-platform/capabilities/web-search.mdx | 4 +++- src/content/docs/agent-platform/cli-agents/claude-code.mdx | 4 +++- src/content/docs/agent-platform/cli-agents/codex.mdx | 4 +++- src/content/docs/agent-platform/cli-agents/opencode.mdx | 4 +++- .../docs/agent-platform/cloud-agents/environments.mdx | 4 +++- .../cloud-agents/integrations/azure-devops.mdx | 4 +++- .../agent-platform/cloud-agents/integrations/bitbucket.mdx | 4 +++- .../agent-platform/cloud-agents/integrations/gitlab.mdx | 4 +++- .../agent-platform/cloud-agents/integrations/linear.mdx | 4 +++- .../docs/agent-platform/cloud-agents/integrations/slack.mdx | 4 +++- src/content/docs/agent-platform/cloud-agents/mcp.mdx | 2 +- src/content/docs/agent-platform/cloud-agents/oz-web-app.mdx | 2 +- src/content/docs/agent-platform/cloud-agents/platform.mdx | 2 +- src/content/docs/agent-platform/cloud-agents/secrets.mdx | 4 +++- .../agent-platform/cloud-agents/self-hosting/monitoring.mdx | 4 +++- .../agent-platform/cloud-agents/self-hosting/unmanaged.mdx | 5 ++--- src/content/docs/agent-platform/getting-started/faqs.mdx | 4 +++- src/content/docs/agent-platform/local-agents/code-diffs.mdx | 4 +++- .../local-agents/interacting-with-agents/voice.mdx | 4 +++- src/content/docs/enterprise/getting-started/faq.mdx | 4 +++- .../enterprise/security-and-compliance/trust-center.mdx | 4 +++- .../docs/enterprise/support-and-resources/billing.mdx | 4 +++- src/content/docs/enterprise/team-management/admin-panel.mdx | 2 +- src/content/docs/enterprise/team-management/teams.mdx | 4 +++- src/content/docs/getting-started/migrate-to-warp/index.mdx | 5 ++--- .../migrate-to-warp/migrate-to-warp-from-macos-terminal.mdx | 5 ++--- .../migrate-to-warp-from-windows-terminal.mdx | 5 ++--- ...ents-in-parallel-summarize-logs-analyze-pr-modify-ui.mdx | 2 +- ...es-for-an-existing-project-astro-typescript-tailwind.mdx | 2 +- ...-mcp-create-a-website-from-a-figma-file-from-scratch.mdx | 2 +- ...ally-code-ui-that-matches-your-mockup-react-tailwind.mdx | 2 +- src/content/docs/reference/api-and-sdk/index.mdx | 4 +++- .../api-and-sdk/troubleshooting/errors/conflict.mdx | 4 +++- src/content/docs/reference/cli/api-keys.mdx | 2 +- src/content/docs/reference/cli/index.mdx | 4 +++- src/content/docs/reference/cli/mcp-servers.mdx | 2 +- src/content/docs/reference/cli/skills.mdx | 4 +++- .../docs/support-and-community/community/contributing.mdx | 3 +-- .../community/warp-preview-and-alpha-program.mdx | 4 +++- .../support-and-community/plans-and-billing/credits.mdx | 4 +++- .../plans-and-billing/pricing-faqs.mdx | 4 +++- .../privacy-and-security/network-log.mdx | 4 +++- .../support-and-community/privacy-and-security/privacy.mdx | 4 +++- .../privacy-and-security/secret-redaction.mdx | 6 ++---- .../troubleshooting-and-support/known-issues.mdx | 4 +++- src/content/docs/terminal/input/universal-input.mdx | 5 ++--- 51 files changed, 125 insertions(+), 65 deletions(-) diff --git a/src/content/docs/agent-platform/capabilities/computer-use.mdx b/src/content/docs/agent-platform/capabilities/computer-use.mdx index 8592ff1..401bd44 100644 --- 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 index 59e8c36..03bf595 100644 --- 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 index 2ee72d2..78761e4 100644 --- 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 index 64f937d..dbe86b0 100644 --- 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 index 49d9370..6dbc30e 100644 --- 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 index 65ad0d3..65a980e 100644 --- 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 index 6f3578f..b765baa 100644 --- 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 index e83173e..e4f0b1a 100644 --- 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 index f1b598e..963f3b9 100644 --- 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 index 8725445..92730a7 100644 --- 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 index 3dccb64..b274fd5 100644 --- 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 for Oz +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 index d6cde7b..92f6cf6 100644 --- 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 for Oz +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 index f971e97..a3d9e24 100644 --- 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 for Oz +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 index 275723a..1246deb 100644 --- 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 for Oz +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 index 707ab2e..7eaa607 100644 --- 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 for Oz +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 index 9ebe8a8..1488e56 100644 --- 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 index f8e96fe..feb4cdb 100644 --- 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 index 7913c03..2773cf2 100644 --- 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 index 6013224..e2caff3 100644 --- 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 index d83356a..993ad87 100644 --- 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 index d8f7bfd..84a2a11 100644 --- 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 index 209ab41..5c237f0 100644 --- 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 index ecf1762..88d8bf0 100644 --- 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 index b2fdaed..4598860 100644 --- 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 index fa5bc73..6ee7aad 100644 --- 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 index d5cbaa5..8d7a11f 100644 --- 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 index c3c6b7c..8110c6a 100644 --- 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 index 03ae0ef..78a3449 100644 --- 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 index 21a749b..544aa3e 100644 --- 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 index dc85062..b94e4ce 100644 --- 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 index 1d04d46..1689561 100644 --- 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 index 247f6a0..b5698ca 100644 --- 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 index c7c339e..0d4ab8c 100644 --- 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 index 7185593..9b03c57 100644 --- 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 index f7c4ec1..da10d3b 100644 --- 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 index 4b59926..8ff1865 100644 --- 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 index 4bd3669..045ca86 100644 --- 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 index ff198b7..24346d2 100644 --- 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 index f4f5c91..1fd9c0e 100644 --- a/src/content/docs/reference/cli/api-keys.mdx +++ b/src/content/docs/reference/cli/api-keys.mdx @@ -1,5 +1,5 @@ --- -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: diff --git a/src/content/docs/reference/cli/index.mdx b/src/content/docs/reference/cli/index.mdx index 76bb785..349d36f 100644 --- 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 index a77f7c5..8392a62 100644 --- a/src/content/docs/reference/cli/mcp-servers.mdx +++ b/src/content/docs/reference/cli/mcp-servers.mdx @@ -1,5 +1,5 @@ --- -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. diff --git a/src/content/docs/reference/cli/skills.mdx b/src/content/docs/reference/cli/skills.mdx index 20ebccd..d855a17 100644 --- a/src/content/docs/reference/cli/skills.mdx +++ b/src/content/docs/reference/cli/skills.mdx @@ -1,5 +1,7 @@ --- -title: "Skills (CLI)" +title: "Skills via the Oz CLI" +sidebar: + label: "Skills" description: >- Use skills with the Oz CLI to run agents from reusable skill definitions stored in your repositories. diff --git a/src/content/docs/support-and-community/community/contributing.mdx b/src/content/docs/support-and-community/community/contributing.mdx index ef12428..40d2482 100644 --- a/src/content/docs/support-and-community/community/contributing.mdx +++ b/src/content/docs/support-and-community/community/contributing.mdx @@ -2,8 +2,7 @@ title: Contributing to Warp description: >- Contribute to Warp's open source client by filing issues, opening pull - requests, building themes, sharing workflows, and publishing Warp Drive - objects to the community. + requests, building themes, and sharing workflows. --- Warp's client is open source under [AGPL v3](https://github.com/warpdotdev/warp/blob/master/LICENSE) at [`warpdotdev/warp`](https://github.com/warpdotdev/warp), and there's room for every kind of contribution — from a one-line bug report to a full feature PR, a new theme, or a workflow that ships to every Warp user. For the full code contribution flow, see [`CONTRIBUTING.md`](https://github.com/warpdotdev/warp/blob/master/CONTRIBUTING.md). 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 index 9ea0954..8d53f06 100644 --- 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 @@ -1,5 +1,7 @@ --- -title: Warp Preview +title: Warp Preview program +sidebar: + label: "Warp Preview" description: >- Warp Preview is an early-access build of Warp with experimental features. Try what's next before it ships. 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 index e6b576a..86e784f 100644 --- a/src/content/docs/support-and-community/plans-and-billing/credits.mdx +++ b/src/content/docs/support-and-community/plans-and-billing/credits.mdx @@ -1,5 +1,7 @@ --- -title: Credits +title: Warp credits and billing +sidebar: + label: "Credits" description: >- Details on Warp credits and how they are calculated. --- 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 index 0d88721..b3580d1 100644 --- 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 @@ -1,5 +1,7 @@ --- -title: Pricing FAQs +title: Pricing and billing FAQs +sidebar: + label: "Pricing FAQs" description: >- Frequently asked questions about upgrading, managing billing, refunds, and invoicing with Warp's paid plans. 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 index ab8e72f..e13bee1 100644 --- 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 @@ -1,5 +1,7 @@ --- -title: Network Log +title: Warp Network Log +sidebar: + label: "Network Log" description: >- Logs for all network traffic (both requests and responses) originating from the current terminal session. 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 index 7df407d..ca9f059 100644 --- a/src/content/docs/support-and-community/privacy-and-security/privacy.mdx +++ b/src/content/docs/support-and-community/privacy-and-security/privacy.mdx @@ -1,5 +1,7 @@ --- -title: Privacy +title: Privacy and data control +sidebar: + label: "Privacy" description: >- Warp's approach to privacy and your control over your data --- 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 index 94131b6..3e59d78 100644 --- 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 @@ -1,10 +1,8 @@ --- title: Secret Redaction description: >- - Secret Redaction automatically redacts secrets and sensitive data in - terminal Secret Redaction attempts to redact secrets and sensitive data in - your Secret Redaction detects and redacts secrets, passwords, API keys, IP - addresses, and PII in your terminal output. + Secret Redaction detects and redacts secrets, passwords, API keys, and PII + in your terminal output before sending data to servers. --- ## How to access it 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 index abdbaf9..81f1849 100644 --- 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 @@ -1,5 +1,7 @@ --- -title: Known Issues +title: Known issues and workarounds +sidebar: + label: "Known Issues" description: >- Known Warp issues with workarounds, including SSH, shells, and incompatible tools. diff --git a/src/content/docs/terminal/input/universal-input.mdx b/src/content/docs/terminal/input/universal-input.mdx index 70ecca0..25d7a8d 100644 --- a/src/content/docs/terminal/input/universal-input.mdx +++ b/src/content/docs/terminal/input/universal-input.mdx @@ -1,9 +1,8 @@ --- title: Universal Input (Legacy) description: >- - Universal Input was the previous default input interface for Warp. It has - been replaced by Agent Modality, which provides a cleaner separation between - terminal and agent workflows. + Universal Input was the previous default input interface for Warp, + replaced by Terminal and Agent modes. sidebar: hidden: true --- From 4420f0cca401821be5a66357c9bf965136baafb2 Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Tue, 5 May 2026 10:54:02 -1000 Subject: [PATCH 2/3] fix: sentence case corrections and skill update for casing rules MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- .agents/skills/docs-seo-audit/SKILL.md | 13 +++++++++++++ .../agent-platform/capabilities/computer-use.mdx | 2 +- .../docs/agent-platform/capabilities/web-search.mdx | 2 +- .../cloud-agents/integrations/azure-devops.mdx | 2 +- .../cloud-agents/integrations/bitbucket.mdx | 2 +- .../cloud-agents/integrations/gitlab.mdx | 2 +- .../cloud-agents/integrations/linear.mdx | 2 +- .../cloud-agents/integrations/slack.mdx | 2 +- src/content/docs/reference/cli/api-keys.mdx | 2 +- src/content/docs/reference/cli/mcp-servers.mdx | 2 +- .../privacy-and-security/network-log.mdx | 4 ++-- .../troubleshooting-and-support/known-issues.mdx | 2 +- 12 files changed, 25 insertions(+), 12 deletions(-) diff --git a/.agents/skills/docs-seo-audit/SKILL.md b/.agents/skills/docs-seo-audit/SKILL.md index b31b96e..f658602 100644 --- 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 index 401bd44..11c48b6 100644 --- a/src/content/docs/agent-platform/capabilities/computer-use.mdx +++ b/src/content/docs/agent-platform/capabilities/computer-use.mdx @@ -1,5 +1,5 @@ --- -title: Computer Use for agents +title: Computer use for agents sidebar: label: "Computer use" description: >- diff --git a/src/content/docs/agent-platform/capabilities/web-search.mdx b/src/content/docs/agent-platform/capabilities/web-search.mdx index 65a980e..2ad03df 100644 --- a/src/content/docs/agent-platform/capabilities/web-search.mdx +++ b/src/content/docs/agent-platform/capabilities/web-search.mdx @@ -1,5 +1,5 @@ --- -title: Agent Web Search +title: Agent web search sidebar: label: "Web search" description: >- 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 index b274fd5..a76169d 100644 --- 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,5 @@ --- -title: Azure DevOps integration for Oz +title: Azure DevOps integration sidebar: label: "Azure DevOps" description: >- diff --git a/src/content/docs/agent-platform/cloud-agents/integrations/bitbucket.mdx b/src/content/docs/agent-platform/cloud-agents/integrations/bitbucket.mdx index 92f6cf6..300f4d1 100644 --- 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,5 @@ --- -title: Bitbucket integration for Oz +title: Bitbucket integration sidebar: label: "Bitbucket" description: >- diff --git a/src/content/docs/agent-platform/cloud-agents/integrations/gitlab.mdx b/src/content/docs/agent-platform/cloud-agents/integrations/gitlab.mdx index a3d9e24..aa6fc21 100644 --- 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,5 @@ --- -title: GitLab integration for Oz +title: GitLab integration sidebar: label: "GitLab" description: >- diff --git a/src/content/docs/agent-platform/cloud-agents/integrations/linear.mdx b/src/content/docs/agent-platform/cloud-agents/integrations/linear.mdx index 1246deb..3b8305f 100644 --- 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,5 @@ --- -title: Linear integration for Oz +title: Linear integration sidebar: label: "Linear" description: >- diff --git a/src/content/docs/agent-platform/cloud-agents/integrations/slack.mdx b/src/content/docs/agent-platform/cloud-agents/integrations/slack.mdx index 7eaa607..da29e2b 100644 --- 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,5 @@ --- -title: Slack integration for Oz +title: Slack integration sidebar: label: "Slack" description: >- diff --git a/src/content/docs/reference/cli/api-keys.mdx b/src/content/docs/reference/cli/api-keys.mdx index 1fd9c0e..4b8b091 100644 --- a/src/content/docs/reference/cli/api-keys.mdx +++ b/src/content/docs/reference/cli/api-keys.mdx @@ -3,7 +3,7 @@ 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/mcp-servers.mdx b/src/content/docs/reference/cli/mcp-servers.mdx index 8392a62..c8e5a19 100644 --- a/src/content/docs/reference/cli/mcp-servers.mdx +++ b/src/content/docs/reference/cli/mcp-servers.mdx @@ -4,7 +4,7 @@ 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/support-and-community/privacy-and-security/network-log.mdx b/src/content/docs/support-and-community/privacy-and-security/network-log.mdx index e13bee1..969221e 100644 --- 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 @@ -1,7 +1,7 @@ --- -title: Warp Network Log +title: Warp network log sidebar: - label: "Network Log" + label: "Network log" description: >- Logs for all network traffic (both requests and responses) originating from the current terminal session. 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 index 81f1849..0dcd53b 100644 --- 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 @@ -1,7 +1,7 @@ --- title: Known issues and workarounds sidebar: - label: "Known Issues" + label: "Known issues" description: >- Known Warp issues with workarounds, including SSH, shells, and incompatible tools. From d84f28c0a0ac5782108d676c4ab2d0333739b1d7 Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Tue, 5 May 2026 10:59:44 -1000 Subject: [PATCH 3/3] fix: remove duplicate sidebar key in skills.mdx frontmatter Co-Authored-By: Oz --- src/content/docs/reference/cli/skills.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/src/content/docs/reference/cli/skills.mdx b/src/content/docs/reference/cli/skills.mdx index d855a17..92c603a 100644 --- a/src/content/docs/reference/cli/skills.mdx +++ b/src/content/docs/reference/cli/skills.mdx @@ -5,8 +5,6 @@ sidebar: description: >- Use skills with the Oz CLI to run agents from reusable skill definitions stored in your repositories. -sidebar: - label: "Skills" --- [Skills](/agent-platform/capabilities/skills/) are reusable instruction sets that teach agents how to perform specific tasks. Use the `--skill` flag to run an agent from a skill in a repository accessible to your environment.