From db17955672399fd4b6a676f872b31b52b260e89f Mon Sep 17 00:00:00 2001
From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com>
Date: Sun, 17 May 2026 14:38:29 -1000
Subject: [PATCH 01/10] feat: card-based Guides discovery page with category
 filtering

- Extend content schema with tags and featured frontmatter fields
- Backfill tags on all 54 guide pages using 15-tag vocabulary
- Mark 6 guides as featured for the curated top section
- Collapse all 7 sidebar groups by default to reduce overwhelm
- Add GuidesLanding.astro component with card grid and filter pills
- Replace static guides/index.mdx with dynamic filterable directory
- Add CSS for cards, filter pills, category badges, and tag chips

Co-Authored-By: Oz <oz-agent@warp.dev>
---
 src/components/GuidesLanding.astro            | 173 ++++++++++++++++++
 src/content.config.ts                         |  20 +-
 .../how-to-edit-agent-code-in-warp.mdx        |   3 +
 ...your-codebase-using-warp-rust-codebase.mdx |   4 +
 .../how-to-review-ai-generated-code.mdx       |   4 +
 .../how-to-review-prs-like-a-senior-dev.mdx   |   4 +
 ...el-summarize-logs-analyze-pr-modify-ui.mdx |   4 +
 .../how-to-run-multiple-ai-coding-agents.mdx  |   3 +
 ...ice-and-images-to-prompt-coding-agents.mdx |   3 +
 ...ning-multiple-agents-at-once-with-warp.mdx |   3 +
 .../understanding-your-codebase.mdx           |   3 +
 .../using-images-as-context-with-warp.mdx     |   3 +
 .../warp-for-product-managers.mdx             |   3 +
 .../agent-workflows/warp-vs-claude-code.mdx   |   4 +
 ...ome-extension-d3js-javascript-html-css.mdx |   4 +
 ...-real-time-chat-app-github-mcp-railway.mdx |   5 +
 .../building-a-slackbot.mdx                   |   3 +
 .../building-warps-input-with-warp.mdx        |   4 +
 .../creating-rules-for-agents.mdx             |   3 +
 ...gure-yolo-and-strategic-agent-profiles.mdx |   3 +
 ...ting-project-astro-typescript-tailwind.mdx |   4 +
 .../how-to-set-coding-best-practices.mdx      |   3 +
 ...w-to-set-coding-preferences-with-rules.mdx |   3 +
 ...-set-tech-stack-preferences-with-rules.mdx |   3 +
 ...-self-serve-data-analytics-with-skills.mdx |   3 +
 .../how-to-sync-your-monorepos.mdx            |   3 +
 .../how-to-use-agent-profiles-efficiently.mdx |   3 +
 ...er-reusable-actions-with-saved-prompts.mdx |   3 +
 .../how-to-analyze-cloud-run-logs-gcloud.mdx  |   3 +
 ...create-a-production-ready-docker-setup.mdx |   3 +
 ...ority-matrix-for-database-optimization.mdx |   3 +
 ...nit-and-security-tests-to-debug-faster.mdx |   3 +
 .../how-to-prevent-secrets-from-leaking.mdx   |   3 +
 ...te-sql-commands-inside-a-postgres-repl.mdx |   3 +
 ...-your-kubernetes-workflow-kubectl-helm.mdx |   3 +
 ...date-astro-project-with-best-practices.mdx |   3 +
 ...website-from-a-figma-file-from-scratch.mdx |   4 +
 ...rizing-open-prs-and-creating-gh-issues.mdx |   4 +
 .../how-to-set-up-claude-code.mdx             |   3 +
 .../how-to-set-up-codex-cli.mdx               |   3 +
 .../how-to-set-up-gemini-cli.mdx              |   3 +
 .../external-tools/how-to-set-up-ollama.mdx   |   3 +
 .../external-tools/how-to-set-up-opencode.mdx |   3 +
 .../linear-mcp-retrieve-issue-data.mdx        |   3 +
 ...ing-tickets-with-a-lean-build-approach.mdx |   3 +
 ...peteer-mcp-scraping-amazon-web-reviews.mdx |   3 +
 ...cp-fix-sentry-error-in-empower-website.mdx |   4 +
 ...asic-queries-you-can-make-after-set-up.mdx |   4 +
 .../using-mcp-servers-with-warp.mdx           |   4 +
 ...hat-matches-your-mockup-react-tailwind.mdx |   3 +
 ...ace-a-ui-element-in-warp-rust-codebase.mdx |   3 +
 .../10-coding-features-you-should-know.mdx    |   4 +
 .../how-to-customize-warps-appearance.mdx     |   3 +
 .../how-to-make-warps-ui-more-minimal.mdx     |   3 +
 .../how-to-master-warps-code-review-panel.mdx |   4 +
 .../getting-started/welcome-to-warp.mdx       |   3 +
 src/content/docs/guides/index.mdx             |  23 +--
 src/sidebar.ts                                |   7 +
 src/styles/custom.css                         | 136 ++++++++++++++
 59 files changed, 517 insertions(+), 21 deletions(-)
 create mode 100644 src/components/GuidesLanding.astro

diff --git a/src/components/GuidesLanding.astro b/src/components/GuidesLanding.astro
new file mode 100644
index 00000000..d1abd1f9
--- /dev/null
+++ b/src/components/GuidesLanding.astro
@@ -0,0 +1,173 @@
+---
+// Pure Astro component for the Guides card-based discovery page.
+// Renders the full card grid at build time; a small inline script
+// handles filter-pill interactivity on the client.
+import { getCollection } from 'astro:content';
+
+const CATEGORY_LABELS: Record<string, string> = {
+	'getting-started': 'Getting started',
+	'agent-workflows': 'Agent workflows',
+	configuration: 'Configuration',
+	'external-tools': 'External tools',
+	'build-an-app-in-warp': 'Build an app',
+	devops: 'DevOps',
+	frontend: 'Frontend & UI',
+};
+
+const allDocs = await getCollection('docs', (entry) =>
+	entry.id.startsWith('guides/') && entry.id !== 'guides' && !entry.id.endsWith('/index'),
+);
+
+interface GuideData {
+	title: string;
+	description: string;
+	href: string;
+	category: string;
+	categoryLabel: string;
+	tags: string[];
+	featured: boolean;
+}
+
+const guides: GuideData[] = allDocs
+	.filter((doc) => {
+		const parts = doc.id.replace(/^guides\//, '').split('/');
+		return parts.length >= 2;
+	})
+	.map((doc) => {
+		const category = doc.id.replace(/^guides\//, '').split('/')[0];
+		return {
+			title: (doc.data as any).sidebar?.label || doc.data.title,
+			description: doc.data.description || '',
+			href: '/' + doc.id.replace(/\.mdx?$/, '') + '/',
+			category,
+			categoryLabel: CATEGORY_LABELS[category] || category,
+			tags: (doc.data as any).tags || [],
+			featured: (doc.data as any).featured || false,
+		};
+	});
+
+const featured = guides.filter((g) => g.featured);
+
+// Derive ordered categories
+const categories = Object.keys(CATEGORY_LABELS).filter((cat) =>
+	guides.some((g) => g.category === cat),
+);
+---
+
+<div class="warp-guide-grid-container not-content">
+	{/* Filter pills */}
+	<div class="warp-guide-filters" role="tablist" aria-label="Filter guides by category">
+		<button
+			role="tab"
+			aria-selected="true"
+			class="warp-guide-filter-pill active"
+			data-filter="all"
+		>
+			All ({guides.length})
+		</button>
+		{categories.map((cat) => {
+			const count = guides.filter((g) => g.category === cat).length;
+			return (
+				<button
+					role="tab"
+					aria-selected="false"
+					class="warp-guide-filter-pill"
+					data-filter={cat}
+				>
+					{CATEGORY_LABELS[cat]} ({count})
+				</button>
+			);
+		})}
+	</div>
+
+	{/* Featured section */}
+	{featured.length > 0 && (
+		<section class="warp-guide-section" data-section="featured">
+			<h2 class="warp-guide-section-heading">Featured</h2>
+			<div class="warp-guide-card-grid">
+				{featured.map((guide) => (
+					<a href={guide.href} class="warp-guide-card" data-category={guide.category}>
+						<span class="warp-guide-card-category">{guide.categoryLabel}</span>
+						<h3 class="warp-guide-card-title">{guide.title}</h3>
+						{guide.description && <p class="warp-guide-card-desc">{guide.description}</p>}
+						{guide.tags.length > 0 && (
+							<div class="warp-guide-card-tags">
+								{guide.tags.map((tag) => (
+									<span class="warp-guide-card-tag">{tag}</span>
+								))}
+							</div>
+						)}
+					</a>
+				))}
+			</div>
+		</section>
+	)}
+
+	{/* All guides */}
+	<section class="warp-guide-section" data-section="all">
+		{featured.length > 0 && <h2 class="warp-guide-section-heading">All guides</h2>}
+		<div class="warp-guide-card-grid">
+			{guides.map((guide) => (
+				<a href={guide.href} class="warp-guide-card" data-category={guide.category}>
+					<span class="warp-guide-card-category">{guide.categoryLabel}</span>
+					<h3 class="warp-guide-card-title">{guide.title}</h3>
+					{guide.description && <p class="warp-guide-card-desc">{guide.description}</p>}
+					{guide.tags.length > 0 && (
+						<div class="warp-guide-card-tags">
+							{guide.tags.map((tag) => (
+								<span class="warp-guide-card-tag">{tag}</span>
+							))}
+						</div>
+					)}
+				</a>
+			))}
+		</div>
+	</section>
+</div>
+
+<script is:inline>
+	// Client-side filter pill interactivity
+	(() => {
+		const container = document.querySelector('.warp-guide-grid-container');
+		if (!container) return;
+
+		const pills = container.querySelectorAll('.warp-guide-filter-pill');
+		const featuredSection = container.querySelector('[data-section="featured"]');
+		const allSection = container.querySelector('[data-section="all"]');
+		const allCards = allSection?.querySelectorAll('.warp-guide-card') ?? [];
+		const allHeading = allSection?.querySelector('.warp-guide-section-heading');
+
+		pills.forEach((pill) => {
+			pill.addEventListener('click', () => {
+				const filter = pill.getAttribute('data-filter');
+
+				// Update pill states
+				pills.forEach((p) => {
+					p.classList.remove('active');
+					p.setAttribute('aria-selected', 'false');
+				});
+				pill.classList.add('active');
+				pill.setAttribute('aria-selected', 'true');
+
+				// Show/hide featured section
+				if (featuredSection) {
+					featuredSection.style.display = filter === 'all' ? '' : 'none';
+				}
+
+				// Show/hide "All guides" heading
+				if (allHeading) {
+					allHeading.style.display = filter === 'all' ? '' : 'none';
+				}
+
+				// Filter cards
+				allCards.forEach((card) => {
+					if (filter === 'all' || card.getAttribute('data-category') === filter) {
+						card.style.display = '';
+					} else {
+						card.style.display = 'none';
+					}
+				});
+			});
+		});
+	})();
+</script>
diff --git a/src/content.config.ts b/src/content.config.ts
index 7097d029..8d3237be 100644
--- a/src/content.config.ts
+++ b/src/content.config.ts
@@ -2,10 +2,28 @@ import { defineCollection } from 'astro:content';
 import { docsLoader } from '@astrojs/starlight/loaders';
 import { docsSchema } from '@astrojs/starlight/schema';
 import { topicSchema } from 'starlight-sidebar-topics/schema';
+import { z } from 'astro/zod';
 
 export const collections = {
 	// `topicSchema` adds a `topic` frontmatter field used by
 	// `starlight-sidebar-topics` to associate unlisted pages with a topic ID.
 	// See guides/agent-workflows/warp-vs-claude-code.mdx for an example.
-	docs: defineCollection({ loader: docsLoader(), schema: docsSchema({ extend: topicSchema }) }),
+	//
+	// Custom fields added for the Guides card-based discovery page:
+	// - `tags`: topic/task tags for filtering (e.g. ["mcp", "agents", "docker"])
+	// - `featured`: marks guides for the curated "Featured" section
+	docs: defineCollection({
+		loader: docsLoader(),
+		schema: docsSchema({
+			extend: (context) => {
+				const topic = typeof topicSchema === 'function' ? topicSchema(context) : topicSchema;
+				return topic.merge(
+					z.object({
+						tags: z.array(z.string()).optional(),
+						featured: z.boolean().optional().default(false),
+					}),
+				);
+			},
+		}),
+	}),
 };
diff --git a/src/content/docs/guides/agent-workflows/how-to-edit-agent-code-in-warp.mdx b/src/content/docs/guides/agent-workflows/how-to-edit-agent-code-in-warp.mdx
index 434a7e38..381734dd 100644
--- a/src/content/docs/guides/agent-workflows/how-to-edit-agent-code-in-warp.mdx
+++ b/src/content/docs/guides/agent-workflows/how-to-edit-agent-code-in-warp.mdx
@@ -5,6 +5,9 @@ description: >-
   reject, or modify changes before applying them.
 sidebar:
   label: "Edit Agent code in Warp"
+tags:
+  - "agents"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
diff --git a/src/content/docs/guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase.mdx b/src/content/docs/guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase.mdx
index 02b00c8b..f539491e 100644
--- a/src/content/docs/guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase.mdx
+++ b/src/content/docs/guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase.mdx
@@ -6,6 +6,10 @@ description: >-
   project.
 sidebar:
   label: "Explain your codebase using Warp"
+tags:
+  - "agents"
+featured: true
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/agent-workflows/how-to-review-ai-generated-code.mdx b/src/content/docs/guides/agent-workflows/how-to-review-ai-generated-code.mdx
index f0c60083..c5e488d9 100644
--- a/src/content/docs/guides/agent-workflows/how-to-review-ai-generated-code.mdx
+++ b/src/content/docs/guides/agent-workflows/how-to-review-ai-generated-code.mdx
@@ -5,6 +5,10 @@ description: >-
   works with Claude Code, Codex, or any CLI agent.
 sidebar:
   label: "Review AI-generated code"
+tags:
+  - "agents"
+  - "code-review"
+
 ---
 
 Coding agents can produce hundreds of lines of code in seconds, but shipping that code without review is risky. This guide provides a practical workflow for reviewing agent-generated code in Warp, catching common issues, and giving structured feedback that the agent can act on. Plan on about 10 minutes to complete.
diff --git a/src/content/docs/guides/agent-workflows/how-to-review-prs-like-a-senior-dev.mdx b/src/content/docs/guides/agent-workflows/how-to-review-prs-like-a-senior-dev.mdx
index ffc49f3f..6b86b129 100644
--- a/src/content/docs/guides/agent-workflows/how-to-review-prs-like-a-senior-dev.mdx
+++ b/src/content/docs/guides/agent-workflows/how-to-review-prs-like-a-senior-dev.mdx
@@ -5,6 +5,10 @@ description: >-
   assessment, critical issues, and merge confidence scoring.
 sidebar:
   label: "Review PRs like a senior dev"
+tags:
+  - "agents"
+  - "code-review"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
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 0d4ab8cf..94f33466 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
@@ -5,6 +5,10 @@ description: >-
   reviews, and summarize production logs in parallel.
 sidebar:
   label: "Run 3 agents in parallel"
+tags:
+  - "agents"
+featured: true
+
 ---
 import { Tabs, TabItem } from '@astrojs/starlight/components';
 import VideoEmbed from '@components/VideoEmbed.astro';
diff --git a/src/content/docs/guides/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx b/src/content/docs/guides/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx
index 21f5e985..bbc53513 100644
--- a/src/content/docs/guides/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx
+++ b/src/content/docs/guides/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx
@@ -6,6 +6,9 @@ description: >-
   once.
 sidebar:
   label: "Run multiple AI coding agents"
+tags:
+  - "agents"
+
 ---
 
 Different agents have different strengths. Claude Code might handle refactoring well while Codex might excel at test generation. Instead of choosing one, you can run them in parallel. Assign different tasks to different agents, compare their outputs on the same problem, or have one agent build while another reviews. This guide shows you how to set up a multi-agent workflow in Warp and manage it effectively. Plan on about 15 minutes.
diff --git a/src/content/docs/guides/agent-workflows/how-to-use-voice-and-images-to-prompt-coding-agents.mdx b/src/content/docs/guides/agent-workflows/how-to-use-voice-and-images-to-prompt-coding-agents.mdx
index c93c2681..ddf34338 100644
--- a/src/content/docs/guides/agent-workflows/how-to-use-voice-and-images-to-prompt-coding-agents.mdx
+++ b/src/content/docs/guides/agent-workflows/how-to-use-voice-and-images-to-prompt-coding-agents.mdx
@@ -5,6 +5,9 @@ description: >-
   with Claude Code, Codex, and any CLI agent.
 sidebar:
   label: "Use voice and images to prompt coding agents"
+tags:
+  - "agents"
+
 ---
 
 Typing detailed prompts for coding agents can be slow. Describing a bug from a screenshot, dictating a complex refactoring plan, or explaining a UI change from a design mockup are examples of tasks that are faster with voice and images than with text alone. This guide shows you how to use multimodal input with any CLI coding agent running in Warp in about 5 minutes.
diff --git a/src/content/docs/guides/agent-workflows/running-multiple-agents-at-once-with-warp.mdx b/src/content/docs/guides/agent-workflows/running-multiple-agents-at-once-with-warp.mdx
index cce8860c..ef35f7ea 100644
--- a/src/content/docs/guides/agent-workflows/running-multiple-agents-at-once-with-warp.mdx
+++ b/src/content/docs/guides/agent-workflows/running-multiple-agents-at-once-with-warp.mdx
@@ -5,6 +5,9 @@ description: >-
   shortcuts, and add tests across repos without losing context.
 sidebar:
   label: "Run multiple agents at once"
+tags:
+  - "agents"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
diff --git a/src/content/docs/guides/agent-workflows/understanding-your-codebase.mdx b/src/content/docs/guides/agent-workflows/understanding-your-codebase.mdx
index ffbaa5cb..4eb2452e 100644
--- a/src/content/docs/guides/agent-workflows/understanding-your-codebase.mdx
+++ b/src/content/docs/guides/agent-workflows/understanding-your-codebase.mdx
@@ -5,6 +5,9 @@ description: >-
   generate architecture summaries, and onboard to unfamiliar features fast.
 sidebar:
   label: "Understand your codebase"
+tags:
+  - "agents"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
diff --git a/src/content/docs/guides/agent-workflows/using-images-as-context-with-warp.mdx b/src/content/docs/guides/agent-workflows/using-images-as-context-with-warp.mdx
index 82dbb86c..912eea0d 100644
--- a/src/content/docs/guides/agent-workflows/using-images-as-context-with-warp.mdx
+++ b/src/content/docs/guides/agent-workflows/using-images-as-context-with-warp.mdx
@@ -5,6 +5,9 @@ description: >-
   generate UI code, debug visual issues, and match Figma designs.
 sidebar:
   label: "Use images as context"
+tags:
+  - "agents"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
diff --git a/src/content/docs/guides/agent-workflows/warp-for-product-managers.mdx b/src/content/docs/guides/agent-workflows/warp-for-product-managers.mdx
index bac5158b..a7e04aca 100644
--- a/src/content/docs/guides/agent-workflows/warp-for-product-managers.mdx
+++ b/src/content/docs/guides/agent-workflows/warp-for-product-managers.mdx
@@ -3,6 +3,9 @@ title: "5 AI agent workflows for product managers"
 description: >-
   Five agent workflows that automate status updates, documentation, Slack search,
   and meeting prep for product managers.
+tags:
+  - "agents"
+
 ---
 Most PM work breaks down into three activities: gathering information, synthesizing it, and communicating the result. These five workflows use Warp's agents and MCP integrations to automate the gathering and speed up the synthesis, so you spend less time switching between tools and more time making decisions. Each workflow takes 5–10 minutes to set up.
 
diff --git a/src/content/docs/guides/agent-workflows/warp-vs-claude-code.mdx b/src/content/docs/guides/agent-workflows/warp-vs-claude-code.mdx
index 97448f83..963f50c9 100644
--- a/src/content/docs/guides/agent-workflows/warp-vs-claude-code.mdx
+++ b/src/content/docs/guides/agent-workflows/warp-vs-claude-code.mdx
@@ -7,6 +7,10 @@ description: >-
 # field associates the page with the Guides topic so starlight-sidebar-topics
 # can resolve it without listing it under any group.
 topic: guides
+tags:
+  - "agents"
+  - "third-party-tools"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
diff --git a/src/content/docs/guides/build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css.mdx b/src/content/docs/guides/build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css.mdx
index 2ef40171..800c0388 100644
--- a/src/content/docs/guides/build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css.mdx
+++ b/src/content/docs/guides/build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css.mdx
@@ -5,6 +5,10 @@ description: >-
   coordinate multiple agents, and publish to the Chrome Web Store.
 sidebar:
   label: "Build a Chrome extension"
+tags:
+  - "build-app"
+  - "frontend"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway.mdx b/src/content/docs/guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway.mdx
index 52526d23..b453d118 100644
--- a/src/content/docs/guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway.mdx
+++ b/src/content/docs/guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway.mdx
@@ -5,6 +5,11 @@ description: >-
   from idea to production, all inside Warp.
 sidebar:
   label: "Build a real-time chat app"
+tags:
+  - "build-app"
+  - "mcp"
+featured: true
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/build-an-app-in-warp/building-a-slackbot.mdx b/src/content/docs/guides/build-an-app-in-warp/building-a-slackbot.mdx
index ce6f06bc..998c049c 100644
--- a/src/content/docs/guides/build-an-app-in-warp/building-a-slackbot.mdx
+++ b/src/content/docs/guides/build-an-app-in-warp/building-a-slackbot.mdx
@@ -5,6 +5,9 @@ description: >-
   directly from Slack using Docker and GitHub integration.
 sidebar:
   label: "Build a Slackbot"
+tags:
+  - "build-app"
+
 ---
 import { Steps } from '@astrojs/starlight/components';
 
diff --git a/src/content/docs/guides/build-an-app-in-warp/building-warps-input-with-warp.mdx b/src/content/docs/guides/build-an-app-in-warp/building-warps-input-with-warp.mdx
index 54a369bc..2661f526 100644
--- a/src/content/docs/guides/build-an-app-in-warp/building-warps-input-with-warp.mdx
+++ b/src/content/docs/guides/build-an-app-in-warp/building-warps-input-with-warp.mdx
@@ -5,6 +5,10 @@ description: >-
   a UI component change in a large Rust codebase.
 sidebar:
   label: "Build Warp's input component"
+tags:
+  - "build-app"
+  - "frontend"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
diff --git a/src/content/docs/guides/configuration/creating-rules-for-agents.mdx b/src/content/docs/guides/configuration/creating-rules-for-agents.mdx
index 5a46b6b3..69a10fce 100644
--- a/src/content/docs/guides/configuration/creating-rules-for-agents.mdx
+++ b/src/content/docs/guides/configuration/creating-rules-for-agents.mdx
@@ -5,6 +5,9 @@ description: >-
   patterns or dependency management — so agents follow your standards.
 sidebar:
   label: "Create Rules for Agents"
+tags:
+  - "rules"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
diff --git a/src/content/docs/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx b/src/content/docs/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx
index e93c7d6c..f91f0fb0 100644
--- a/src/content/docs/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx
+++ b/src/content/docs/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx
@@ -5,6 +5,9 @@ description: >-
   and execution speed — demonstrated with YOLO and Strategic examples.
 sidebar:
   label: "Configure YOLO and strategic Agent Profiles"
+tags:
+  - "profiles"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
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 9b03c575..9b46704d 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
@@ -5,6 +5,10 @@ description: >-
   understand your project's setup, commands, architecture, and conventions.
 sidebar:
   label: "Create project Rules for an existing project"
+tags:
+  - "rules"
+featured: true
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps, FileTree } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/configuration/how-to-set-coding-best-practices.mdx b/src/content/docs/guides/configuration/how-to-set-coding-best-practices.mdx
index c95ed7a4..bca70e0b 100644
--- a/src/content/docs/guides/configuration/how-to-set-coding-best-practices.mdx
+++ b/src/content/docs/guides/configuration/how-to-set-coding-best-practices.mdx
@@ -5,6 +5,9 @@ description: >-
   documentation quality across AI-generated code.
 sidebar:
   label: "Set coding best practices"
+tags:
+  - "rules"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/configuration/how-to-set-coding-preferences-with-rules.mdx b/src/content/docs/guides/configuration/how-to-set-coding-preferences-with-rules.mdx
index a8e79391..22c3e8cf 100644
--- a/src/content/docs/guides/configuration/how-to-set-coding-preferences-with-rules.mdx
+++ b/src/content/docs/guides/configuration/how-to-set-coding-preferences-with-rules.mdx
@@ -5,6 +5,9 @@ description: >-
   Rules so agents automatically use pnpm, miniconda, or your preferred tools.
 sidebar:
   label: "Set coding preferences with Rules"
+tags:
+  - "rules"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/configuration/how-to-set-tech-stack-preferences-with-rules.mdx b/src/content/docs/guides/configuration/how-to-set-tech-stack-preferences-with-rules.mdx
index ec6c63f2..968f4d43 100644
--- a/src/content/docs/guides/configuration/how-to-set-tech-stack-preferences-with-rules.mdx
+++ b/src/content/docs/guides/configuration/how-to-set-tech-stack-preferences-with-rules.mdx
@@ -5,6 +5,9 @@ description: >-
   consistently use Astro, SvelteKit, Vite, or your tools of choice.
 sidebar:
   label: "Set tech stack preferences with Rules"
+tags:
+  - "rules"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
diff --git a/src/content/docs/guides/configuration/how-to-set-up-self-serve-data-analytics-with-skills.mdx b/src/content/docs/guides/configuration/how-to-set-up-self-serve-data-analytics-with-skills.mdx
index d9d78fe2..ee19b8fb 100644
--- a/src/content/docs/guides/configuration/how-to-set-up-self-serve-data-analytics-with-skills.mdx
+++ b/src/content/docs/guides/configuration/how-to-set-up-self-serve-data-analytics-with-skills.mdx
@@ -5,6 +5,9 @@ description: >-
   Skills that map questions to dbt models and structure reproducible analyses.
 sidebar:
   label: "Set up self-serve data analytics with skills"
+tags:
+  - "skills"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
diff --git a/src/content/docs/guides/configuration/how-to-sync-your-monorepos.mdx b/src/content/docs/guides/configuration/how-to-sync-your-monorepos.mdx
index a8edcfc2..ec589421 100644
--- a/src/content/docs/guides/configuration/how-to-sync-your-monorepos.mdx
+++ b/src/content/docs/guides/configuration/how-to-sync-your-monorepos.mdx
@@ -5,6 +5,9 @@ description: >-
   client types automatically synchronized across repositories.
 sidebar:
   label: "Sync your monorepos"
+tags:
+  - "rules"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/configuration/how-to-use-agent-profiles-efficiently.mdx b/src/content/docs/guides/configuration/how-to-use-agent-profiles-efficiently.mdx
index 2fdb7fb5..391dee54 100644
--- a/src/content/docs/guides/configuration/how-to-use-agent-profiles-efficiently.mdx
+++ b/src/content/docs/guides/configuration/how-to-use-agent-profiles-efficiently.mdx
@@ -5,6 +5,9 @@ description: >-
   balance of planning, safety, and speed for your project.
 sidebar:
   label: "Use Agent Profiles efficiently"
+tags:
+  - "profiles"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
diff --git a/src/content/docs/guides/configuration/trigger-reusable-actions-with-saved-prompts.mdx b/src/content/docs/guides/configuration/trigger-reusable-actions-with-saved-prompts.mdx
index 51ac55c0..5a5f5e18 100644
--- a/src/content/docs/guides/configuration/trigger-reusable-actions-with-saved-prompts.mdx
+++ b/src/content/docs/guides/configuration/trigger-reusable-actions-with-saved-prompts.mdx
@@ -5,6 +5,9 @@ description: >-
   PR creation across your team.
 sidebar:
   label: "Trigger reusable actions with saved prompts"
+tags:
+  - "rules"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
diff --git a/src/content/docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx b/src/content/docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx
index e692ae45..a1b73978 100644
--- a/src/content/docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx
+++ b/src/content/docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx
@@ -5,6 +5,9 @@ description: >-
   severity with natural language prompts and automated Python scripts.
 sidebar:
   label: "Analyze cloud run logs"
+tags:
+  - "cloud"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/devops/how-to-create-a-production-ready-docker-setup.mdx b/src/content/docs/guides/devops/how-to-create-a-production-ready-docker-setup.mdx
index d6b224d7..a516335b 100644
--- a/src/content/docs/guides/devops/how-to-create-a-production-ready-docker-setup.mdx
+++ b/src/content/docs/guides/devops/how-to-create-a-production-ready-docker-setup.mdx
@@ -5,6 +5,9 @@ description: >-
   configs, and .dockerignore files for multi-stage production deployments.
 sidebar:
   label: "Create a production-ready Docker setup"
+tags:
+  - "docker"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/devops/how-to-create-priority-matrix-for-database-optimization.mdx b/src/content/docs/guides/devops/how-to-create-priority-matrix-for-database-optimization.mdx
index cde53bdb..7caf02cb 100644
--- a/src/content/docs/guides/devops/how-to-create-priority-matrix-for-database-optimization.mdx
+++ b/src/content/docs/guides/devops/how-to-create-priority-matrix-for-database-optimization.mdx
@@ -5,6 +5,9 @@ description: >-
   priority matrix ranking database optimizations by impact and effort.
 sidebar:
   label: "Create a priority matrix for database optimization"
+tags:
+  - "database"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/devops/how-to-generate-unit-and-security-tests-to-debug-faster.mdx b/src/content/docs/guides/devops/how-to-generate-unit-and-security-tests-to-debug-faster.mdx
index 2c426e56..572d7a47 100644
--- a/src/content/docs/guides/devops/how-to-generate-unit-and-security-tests-to-debug-faster.mdx
+++ b/src/content/docs/guides/devops/how-to-generate-unit-and-security-tests-to-debug-faster.mdx
@@ -5,6 +5,9 @@ description: >-
   including SQL injection, XSS, and auth validation checks.
 sidebar:
   label: "Generate unit and security tests to debug faster"
+tags:
+  - "testing"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/devops/how-to-prevent-secrets-from-leaking.mdx b/src/content/docs/guides/devops/how-to-prevent-secrets-from-leaking.mdx
index 0d3f2086..fd4d2eb9 100644
--- a/src/content/docs/guides/devops/how-to-prevent-secrets-from-leaking.mdx
+++ b/src/content/docs/guides/devops/how-to-prevent-secrets-from-leaking.mdx
@@ -5,6 +5,9 @@ description: >-
   credentials from leaking in agent output, demos, and shared sessions.
 sidebar:
   label: "Prevent secrets from leaking"
+tags:
+  - "cloud"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/devops/how-to-write-sql-commands-inside-a-postgres-repl.mdx b/src/content/docs/guides/devops/how-to-write-sql-commands-inside-a-postgres-repl.mdx
index cc6965cf..54626761 100644
--- a/src/content/docs/guides/devops/how-to-write-sql-commands-inside-a-postgres-repl.mdx
+++ b/src/content/docs/guides/devops/how-to-write-sql-commands-inside-a-postgres-repl.mdx
@@ -5,6 +5,9 @@ description: >-
   SQL queries — works with Node.js, Python, and MySQL too.
 sidebar:
   label: "Write SQL commands inside a Postgres REPL"
+tags:
+  - "database"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/devops/improve-your-kubernetes-workflow-kubectl-helm.mdx b/src/content/docs/guides/devops/improve-your-kubernetes-workflow-kubectl-helm.mdx
index 956a65ba..5b652215 100644
--- a/src/content/docs/guides/devops/improve-your-kubernetes-workflow-kubectl-helm.mdx
+++ b/src/content/docs/guides/devops/improve-your-kubernetes-workflow-kubectl-helm.mdx
@@ -5,6 +5,9 @@ description: >-
   suggestions, custom workflows, and synchronized panes.
 sidebar:
   label: "Improve your Kubernetes workflow"
+tags:
+  - "kubernetes"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/external-tools/context7-mcp-update-astro-project-with-best-practices.mdx b/src/content/docs/guides/external-tools/context7-mcp-update-astro-project-with-best-practices.mdx
index cce05fc0..2114ba8a 100644
--- a/src/content/docs/guides/external-tools/context7-mcp-update-astro-project-with-best-practices.mdx
+++ b/src/content/docs/guides/external-tools/context7-mcp-update-astro-project-with-best-practices.mdx
@@ -5,6 +5,9 @@ description: >-
   framework documentation for automated project upgrades.
 sidebar:
   label: "Context7 MCP: update Astro project with best practices"
+tags:
+  - "mcp"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
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 da10d3be..e9a3c4d5 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
@@ -5,6 +5,10 @@ description: >-
   code directly from your design files.
 sidebar:
   label: "Figma remote MCP: create a website from a Figma file"
+tags:
+  - "mcp"
+  - "frontend"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues.mdx b/src/content/docs/guides/external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues.mdx
index 651354bf..a4f71951 100644
--- a/src/content/docs/guides/external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues.mdx
+++ b/src/content/docs/guides/external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues.mdx
@@ -5,6 +5,10 @@ description: >-
   from TODO comments, and automate repo management.
 sidebar:
   label: "GitHub MCP: summarize open PRs and create GitHub issues"
+tags:
+  - "mcp"
+  - "code-review"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
diff --git a/src/content/docs/guides/external-tools/how-to-set-up-claude-code.mdx b/src/content/docs/guides/external-tools/how-to-set-up-claude-code.mdx
index f4b0044f..378d38f6 100644
--- a/src/content/docs/guides/external-tools/how-to-set-up-claude-code.mdx
+++ b/src/content/docs/guides/external-tools/how-to-set-up-claude-code.mdx
@@ -5,6 +5,9 @@ description: >-
   productivity tips — from voice prompting to visual code review.
 sidebar:
   label: "Set up Claude Code"
+tags:
+  - "third-party-tools"
+
 ---
 
 Claude Code is Anthropic's AI coding agent. It reads your codebase, writes and edits code, runs commands, and handles complex refactors using natural language prompts. This guide takes you from zero to a working Claude Code session in Warp in about 5 minutes, then shows you how to get the most out of it.
diff --git a/src/content/docs/guides/external-tools/how-to-set-up-codex-cli.mdx b/src/content/docs/guides/external-tools/how-to-set-up-codex-cli.mdx
index 6ea6efac..0124f9c1 100644
--- a/src/content/docs/guides/external-tools/how-to-set-up-codex-cli.mdx
+++ b/src/content/docs/guides/external-tools/how-to-set-up-codex-cli.mdx
@@ -5,6 +5,9 @@ description: >-
   productivity tips for faster AI-assisted coding workflows in Warp.
 sidebar:
   label: "Set up Codex CLI"
+tags:
+  - "third-party-tools"
+
 ---
 
 Codex CLI is OpenAI's open-source coding agent. It reads your codebase, edits files, and executes commands from natural language prompts. This guide takes you from installation to a working Codex session in Warp in about 5 minutes, then shows you how to get the most out of it.
diff --git a/src/content/docs/guides/external-tools/how-to-set-up-gemini-cli.mdx b/src/content/docs/guides/external-tools/how-to-set-up-gemini-cli.mdx
index 6be725af..d58df2c6 100644
--- a/src/content/docs/guides/external-tools/how-to-set-up-gemini-cli.mdx
+++ b/src/content/docs/guides/external-tools/how-to-set-up-gemini-cli.mdx
@@ -5,6 +5,9 @@ description: >-
   productivity tips for faster AI-assisted coding workflows.
 sidebar:
   label: "Set up Gemini CLI"
+tags:
+  - "third-party-tools"
+
 ---
 
 Gemini CLI is Google's open-source coding agent. It brings Gemini directly into your terminal with built-in tools for file operations, shell commands, web search, and MCP support. This guide takes you from installation to a working Gemini CLI session in Warp in about 5 minutes, then shows you how to get the most out of it.
diff --git a/src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx b/src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx
index 9df5eebb..220d0616 100644
--- a/src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx
+++ b/src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx
@@ -5,6 +5,9 @@ description: >-
   local models into your apps using Warp.
 sidebar:
   label: "Set up Ollama"
+tags:
+  - "third-party-tools"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
diff --git a/src/content/docs/guides/external-tools/how-to-set-up-opencode.mdx b/src/content/docs/guides/external-tools/how-to-set-up-opencode.mdx
index c7ac065e..1b83219b 100644
--- a/src/content/docs/guides/external-tools/how-to-set-up-opencode.mdx
+++ b/src/content/docs/guides/external-tools/how-to-set-up-opencode.mdx
@@ -5,6 +5,9 @@ description: >-
   productivity tips for faster AI-assisted coding workflows.
 sidebar:
   label: "Set up OpenCode"
+tags:
+  - "third-party-tools"
+
 ---
 
 OpenCode is an open-source coding agent that runs in your terminal. It supports 75+ LLM providers, features a built-in terminal UI (TUI), and lets you edit code, execute commands, and manage sessions from natural language prompts. This guide takes you from installation to a working OpenCode session in Warp in about 5 minutes, then shows you how to get the most out of it.
diff --git a/src/content/docs/guides/external-tools/linear-mcp-retrieve-issue-data.mdx b/src/content/docs/guides/external-tools/linear-mcp-retrieve-issue-data.mdx
index fa0e7699..4b19683a 100644
--- a/src/content/docs/guides/external-tools/linear-mcp-retrieve-issue-data.mdx
+++ b/src/content/docs/guides/external-tools/linear-mcp-retrieve-issue-data.mdx
@@ -3,6 +3,9 @@ title: "Linear MCP: Retrieve issue data"
 description: >-
   Add the Linear MCP server to Warp and query your issues, tasks, and
   assignments directly from the terminal.
+tags:
+  - "mcp"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
diff --git a/src/content/docs/guides/external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach.mdx b/src/content/docs/guides/external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach.mdx
index 6fb49991..1494f01c 100644
--- a/src/content/docs/guides/external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach.mdx
+++ b/src/content/docs/guides/external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach.mdx
@@ -5,6 +5,9 @@ description: >-
   changes to subtasks, and maintain a lean build strategy.
 sidebar:
   label: "Linear MCP: update tickets with a lean build approach"
+tags:
+  - "mcp"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/external-tools/puppeteer-mcp-scraping-amazon-web-reviews.mdx b/src/content/docs/guides/external-tools/puppeteer-mcp-scraping-amazon-web-reviews.mdx
index 0e0798f0..d3fddcab 100644
--- a/src/content/docs/guides/external-tools/puppeteer-mcp-scraping-amazon-web-reviews.mdx
+++ b/src/content/docs/guides/external-tools/puppeteer-mcp-scraping-amazon-web-reviews.mdx
@@ -5,6 +5,9 @@ description: >-
   navigating sites, scraping product data, and analyzing reviews.
 sidebar:
   label: "Puppeteer MCP: scrape Amazon web reviews"
+tags:
+  - "mcp"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx b/src/content/docs/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx
index 7f07f7c5..1eb52fcc 100644
--- a/src/content/docs/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx
+++ b/src/content/docs/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx
@@ -5,6 +5,10 @@ description: >-
   traces, and auto-generate fixes for production issues.
 sidebar:
   label: "Sentry MCP: fix Sentry error in empower website"
+tags:
+  - "mcp"
+featured: true
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up.mdx b/src/content/docs/guides/external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up.mdx
index 9ded16a5..c775640a 100644
--- a/src/content/docs/guides/external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up.mdx
+++ b/src/content/docs/guides/external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up.mdx
@@ -5,6 +5,10 @@ description: >-
   against your local database and payment data.
 sidebar:
   label: "SQLite and Stripe MCP: basic queries you can make after setup"
+tags:
+  - "mcp"
+  - "database"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/external-tools/using-mcp-servers-with-warp.mdx b/src/content/docs/guides/external-tools/using-mcp-servers-with-warp.mdx
index 183ad825..58037ac6 100644
--- a/src/content/docs/guides/external-tools/using-mcp-servers-with-warp.mdx
+++ b/src/content/docs/guides/external-tools/using-mcp-servers-with-warp.mdx
@@ -5,6 +5,10 @@ description: >-
   and resolve tickets using external systems like Linear.
 sidebar:
   label: "Connect Agents to MCP servers"
+tags:
+  - "mcp"
+featured: true
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
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 8ff1865a..1b2b3e1f 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
@@ -5,6 +5,9 @@ description: >-
   mockups, with structured specs and iterative refinement.
 sidebar:
   label: "Actually code UI that matches your mockup"
+tags:
+  - "frontend"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/frontend/how-to-replace-a-ui-element-in-warp-rust-codebase.mdx b/src/content/docs/guides/frontend/how-to-replace-a-ui-element-in-warp-rust-codebase.mdx
index f1455116..764514de 100644
--- a/src/content/docs/guides/frontend/how-to-replace-a-ui-element-in-warp-rust-codebase.mdx
+++ b/src/content/docs/guides/frontend/how-to-replace-a-ui-element-in-warp-rust-codebase.mdx
@@ -5,6 +5,9 @@ description: >-
   Rust codebase — with live diffs, auto-compilation, and self-correction.
 sidebar:
   label: "Replace a UI element in Warp"
+tags:
+  - "frontend"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 import { Steps } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/getting-started/10-coding-features-you-should-know.mdx b/src/content/docs/guides/getting-started/10-coding-features-you-should-know.mdx
index ae95af78..42cfc193 100644
--- a/src/content/docs/guides/getting-started/10-coding-features-you-should-know.mdx
+++ b/src/content/docs/guides/getting-started/10-coding-features-you-should-know.mdx
@@ -5,6 +5,10 @@ description: >-
   find and replace, syntax highlighting, code review panel, and more.
 sidebar:
   label: "10 coding features you should know"
+tags:
+  - "getting-started"
+  - "agents"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
diff --git a/src/content/docs/guides/getting-started/how-to-customize-warps-appearance.mdx b/src/content/docs/guides/getting-started/how-to-customize-warps-appearance.mdx
index 0b9799f8..4eb37411 100644
--- a/src/content/docs/guides/getting-started/how-to-customize-warps-appearance.mdx
+++ b/src/content/docs/guides/getting-started/how-to-customize-warps-appearance.mdx
@@ -5,6 +5,9 @@ description: >-
   team collaboration, and visual appearance to fit your workflow.
 sidebar:
   label: "Customize Warp's appearance"
+tags:
+  - "getting-started"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
diff --git a/src/content/docs/guides/getting-started/how-to-make-warps-ui-more-minimal.mdx b/src/content/docs/guides/getting-started/how-to-make-warps-ui-more-minimal.mdx
index 31890412..ef89d695 100644
--- a/src/content/docs/guides/getting-started/how-to-make-warps-ui-more-minimal.mdx
+++ b/src/content/docs/guides/getting-started/how-to-make-warps-ui-more-minimal.mdx
@@ -5,6 +5,9 @@ description: >-
   theme, using the classic prompt, and hiding the tab bar.
 sidebar:
   label: "Make Warp's UI more minimal"
+tags:
+  - "getting-started"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
diff --git a/src/content/docs/guides/getting-started/how-to-master-warps-code-review-panel.mdx b/src/content/docs/guides/getting-started/how-to-master-warps-code-review-panel.mdx
index 04643fbc..2f33c0b6 100644
--- a/src/content/docs/guides/getting-started/how-to-master-warps-code-review-panel.mdx
+++ b/src/content/docs/guides/getting-started/how-to-master-warps-code-review-panel.mdx
@@ -6,6 +6,10 @@ description: >-
   terminal.
 sidebar:
   label: "Master Warp's Code Review panel"
+tags:
+  - "getting-started"
+  - "code-review"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
diff --git a/src/content/docs/guides/getting-started/welcome-to-warp.mdx b/src/content/docs/guides/getting-started/welcome-to-warp.mdx
index a7a2ba47..9bfa48d2 100644
--- a/src/content/docs/guides/getting-started/welcome-to-warp.mdx
+++ b/src/content/docs/guides/getting-started/welcome-to-warp.mdx
@@ -3,6 +3,9 @@ title: Welcome to Warp
 description: >-
   Get oriented with Warp's agentic terminal. Learn the basics of prompt-based
   coding, blending terminal and agent workflows, and navigating the interface.
+tags:
+  - "getting-started"
+
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
diff --git a/src/content/docs/guides/index.mdx b/src/content/docs/guides/index.mdx
index 6df8c5c6..65b3f41f 100644
--- a/src/content/docs/guides/index.mdx
+++ b/src/content/docs/guides/index.mdx
@@ -6,30 +6,13 @@ description: >-
   builds.
 ---
 
-Practical, task-oriented walkthroughs that help you get productive with Warp's coding agents. Each guide walks through a real AI coding workflow with actual prompts, code, and reproducible results.
+import GuidesLanding from '@components/GuidesLanding.astro';
 
-Browse by topic in the sidebar, or start with one of these featured guides.
+Practical, task-oriented walkthroughs that help you get productive with Warp's coding agents. Each guide walks through a real AI coding workflow with actual prompts, code, and reproducible results.
 
 :::note
 **New to Warp?** Start with [Welcome to Warp](/guides/getting-started/welcome-to-warp/), then explore [10 Warp Coding Features You Should Know](/guides/getting-started/10-coding-features-you-should-know/).
 :::
 
-## Featured guides
-
-- [**Explain your codebase with agents**](/guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase/) — Use semantic and symbol search to explore and understand unfamiliar code.
-- [**Create project rules**](/guides/configuration/how-to-create-project-rules-for-an-existing-project-astro-typescript-tailwind/) — Set up an AGENTS.md file so coding agents always understand your project’s setup and conventions.
-- [**Fix errors with Sentry MCP**](/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website/) — Connect the Sentry MCP server to Warp and auto-diagnose production errors.
-- [**Run multiple agents in parallel**](/guides/agent-workflows/how-to-run-3-agents-in-parallel-summarize-logs-analyze-pr-modify-ui/) — Work on coding, debugging, and analysis tasks simultaneously across tabs.
-- [**Build a real-time chat app**](/guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway/) — Go from idea to deployed app with FastAPI, JavaScript, and GitHub MCP — all inside Warp.
-- [**Connect agents to external tools**](/guides/external-tools/using-mcp-servers-with-warp/) — Set up MCP servers to give agents access to Linear, GitHub, Figma, and more.
-
-## What’s in this section
-
-* **Getting started** — First steps with Warp: setup, appearance, key features
-* **Agent workflows** — Use coding agents to explain code, review PRs, and run parallel tasks
-* **Configuration** — Rules, agent profiles, saved prompts, and monorepo sync
-* **External tools & integrations** — Connect coding agents to Sentry, Figma, Linear, GitHub, and more via MCP
-* **Build an app in Warp** — End-to-end app builds with AI coding workflows: chat apps, Chrome extensions, Slackbots
-* **DevOps & infrastructure** — Agent-assisted cloud logs, Docker, Kubernetes, testing, and database optimization
-* **Frontend & UI** — Build and refine UI components with coding agents
+<GuidesLanding />
 
diff --git a/src/sidebar.ts b/src/sidebar.ts
index 98c98b44..183fbc7d 100644
--- a/src/sidebar.ts
+++ b/src/sidebar.ts
@@ -572,6 +572,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
 				{ slug: 'guides', label: 'Guides' },
 				{
 					label: 'Getting started',
+					collapsed: true,
 					items: [
 						'guides/getting-started/welcome-to-warp',
 						{ slug: 'guides/getting-started/10-coding-features-you-should-know', label: '10 Warp Coding Features You Should Know' },
@@ -582,6 +583,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
 				},
 				{
 					label: 'Agent workflows',
+					collapsed: true,
 					items: [
 						{ slug: 'guides/agent-workflows/how-to-review-ai-generated-code', label: 'Review AI-Generated Code' },
 						{ slug: 'guides/agent-workflows/how-to-run-multiple-ai-coding-agents', label: 'Run Multiple AI Coding Agents' },
@@ -598,6 +600,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
 				},
 				{
 					label: 'Configuration',
+					collapsed: true,
 					items: [
 						{ slug: 'guides/configuration/how-to-create-project-rules-for-an-existing-project-astro-typescript-tailwind', label: 'Create Project Rules' },
 						{ slug: 'guides/configuration/how-to-set-coding-best-practices', label: 'Set Coding Best Practices with Rules' },
@@ -613,6 +616,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
 				},
 				{
 					label: 'External tools & integrations',
+					collapsed: true,
 					items: [
 						{ slug: 'guides/external-tools/how-to-set-up-claude-code', label: 'Set Up Claude Code' },
 						{ slug: 'guides/external-tools/how-to-set-up-codex-cli', label: 'Set Up Codex CLI' },
@@ -632,6 +636,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
 				},
 				{
 					label: 'Build an app in Warp',
+					collapsed: true,
 					items: [
 						{ slug: 'guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway', label: 'Build a Real-time Chat App' },
 						{ slug: 'guides/build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css', label: 'Build a Chrome Extension' },
@@ -641,6 +646,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
 				},
 				{
 					label: 'DevOps & infrastructure',
+					collapsed: true,
 					items: [
 						{ slug: 'guides/devops/how-to-analyze-cloud-run-logs-gcloud', label: 'Analyze Cloud Run Logs (gcloud)' },
 						{ slug: 'guides/devops/how-to-create-a-production-ready-docker-setup', label: 'Create a Production-Ready Docker Setup' },
@@ -653,6 +659,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
 				},
 				{
 					label: 'Frontend & UI',
+					collapsed: true,
 					items: [
 						{ slug: 'guides/frontend/how-to-replace-a-ui-element-in-warp-rust-codebase', label: 'Replace a UI Element (Rust Codebase)' },
 						{ slug: 'guides/frontend/how-to-actually-code-ui-that-matches-your-mockup-react-tailwind', label: 'Code UI That Matches Your Mockup (React + Tailwind)' },
diff --git a/src/styles/custom.css b/src/styles/custom.css
index 6d9bfdab..78b1b109 100644
--- a/src/styles/custom.css
+++ b/src/styles/custom.css
@@ -349,3 +349,139 @@ body {
 .sl-markdown-content li > :is(ul, ol) {
   margin-top: 0.5rem;
 }
+
+/* --------------------------------------------------------------------------
+   Guides: Card-based discovery page
+
+   Filter pills + card grid for the /guides/ landing page.
+   Visually distinct from the site-wide topic nav: smaller rounded pills
+   placed below the page intro, clearly scoped to filtering the grid below.
+   -------------------------------------------------------------------------- */
+.warp-guide-filters {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+  margin-bottom: 2rem;
+  padding-bottom: 1rem;
+  border-bottom: 1px solid var(--sl-color-hairline-light);
+}
+
+.warp-guide-filter-pill {
+  appearance: none;
+  border: 1px solid var(--sl-color-gray-5);
+  border-radius: 9999px;
+  background: transparent;
+  color: var(--sl-color-gray-3);
+  font-family: var(--sl-font);
+  font-size: var(--sl-text-xs);
+  font-weight: 500;
+  padding: 0.3rem 0.75rem;
+  cursor: pointer;
+  transition: all 0.15s ease;
+  white-space: nowrap;
+}
+
+.warp-guide-filter-pill:hover {
+  color: var(--sl-color-white);
+  border-color: var(--sl-color-gray-3);
+}
+
+.warp-guide-filter-pill.active {
+  background: var(--sl-color-accent);
+  border-color: var(--sl-color-accent);
+  color: #fff;
+}
+
+:root[data-theme='light'] .warp-guide-filter-pill.active {
+  color: #fff;
+}
+
+.warp-guide-section {
+  margin-bottom: 2rem;
+}
+
+.warp-guide-section-heading {
+  font-size: var(--sl-text-sm);
+  font-weight: 600;
+  color: var(--sl-color-gray-3);
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  margin-bottom: 1rem;
+}
+
+.warp-guide-card-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
+  gap: 1rem;
+}
+
+.warp-guide-card {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+  padding: 1.25rem;
+  border: 1px solid var(--sl-color-hairline-light);
+  border-radius: var(--sl-radius-md);
+  background: transparent;
+  text-decoration: none;
+  color: inherit;
+  transition: border-color 0.15s ease, background 0.15s ease;
+}
+
+.warp-guide-card:hover {
+  border-color: var(--sl-color-gray-5);
+  background: var(--sl-color-gray-6);
+}
+
+.warp-guide-card-category {
+  font-size: var(--sl-text-2xs);
+  font-weight: 600;
+  color: var(--sl-color-accent);
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+}
+
+:root[data-theme='light'] .warp-guide-card-category {
+  color: var(--sl-color-accent);
+}
+
+.warp-guide-card-title {
+  font-size: var(--sl-text-body);
+  font-weight: 600;
+  color: var(--sl-color-white);
+  margin: 0;
+  line-height: 1.3;
+}
+
+.warp-guide-card-desc {
+  font-size: var(--sl-text-sm);
+  color: var(--sl-color-gray-3);
+  margin: 0;
+  line-height: 1.5;
+  display: -webkit-box;
+  -webkit-line-clamp: 3;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+}
+
+.warp-guide-card-tags {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.375rem;
+  margin-top: auto;
+  padding-top: 0.25rem;
+}
+
+.warp-guide-card-tag {
+  font-size: var(--sl-text-2xs);
+  color: var(--sl-color-gray-4);
+  border: 1px solid var(--sl-color-gray-5);
+  border-radius: var(--sl-radius-sm);
+  padding: 0.125rem 0.5rem;
+  line-height: 1.4;
+}
+
+.warp-guide-empty {
+  color: var(--sl-color-gray-4);
+  font-style: italic;
+}

From e5dc055113c8c1e0cfb15f84acda66a826847830 Mon Sep 17 00:00:00 2001
From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com>
Date: Sun, 17 May 2026 15:03:23 -1000
Subject: [PATCH 02/10] fix: resolve TypeScript error in content.config.ts

topicSchema is a Zod object (not a function), so pass it directly
to docsSchema.extend instead of wrapping in a typeof check.

Co-Authored-By: Oz <oz-agent@warp.dev>
---
 src/content.config.ts | 15 ++++++---------
 1 file changed, 6 insertions(+), 9 deletions(-)

diff --git a/src/content.config.ts b/src/content.config.ts
index 8d3237be..592ef93d 100644
--- a/src/content.config.ts
+++ b/src/content.config.ts
@@ -15,15 +15,12 @@ export const collections = {
 	docs: defineCollection({
 		loader: docsLoader(),
 		schema: docsSchema({
-			extend: (context) => {
-				const topic = typeof topicSchema === 'function' ? topicSchema(context) : topicSchema;
-				return topic.merge(
-					z.object({
-						tags: z.array(z.string()).optional(),
-						featured: z.boolean().optional().default(false),
-					}),
-				);
-			},
+			extend: topicSchema.merge(
+				z.object({
+					tags: z.array(z.string()).optional(),
+					featured: z.boolean().optional().default(false),
+				}),
+			),
 		}),
 	}),
 };

From 95b8bbdf9acd151f950fa7c8a812a379a0aff45a Mon Sep 17 00:00:00 2001
From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com>
Date: Mon, 18 May 2026 16:14:59 -1000
Subject: [PATCH 03/10] fix: remove card hover underline, make Featured a
 filter pill

- Add text-decoration: none override on .warp-guide-card:hover and
  child elements to prevent Starlight's global link underline from
  cascading into card text
- Rework Featured from a subsection of 'All' to its own filter pill
  (default active). 'All' now shows everything flat with no special
  section. Single card grid with data-featured attributes for JS
  filtering.

Co-Authored-By: Oz <oz-agent@warp.dev>
---
 src/components/GuidesLanding.astro | 112 +++++++++++++----------------
 src/styles/custom.css              |   6 ++
 2 files changed, 54 insertions(+), 64 deletions(-)

diff --git a/src/components/GuidesLanding.astro b/src/components/GuidesLanding.astro
index d1abd1f9..e919a757 100644
--- a/src/components/GuidesLanding.astro
+++ b/src/components/GuidesLanding.astro
@@ -55,12 +55,22 @@ const categories = Object.keys(CATEGORY_LABELS).filter((cat) =>
 ---
 
 <div class="warp-guide-grid-container not-content">
-	{/* Filter pills */}
+	{/* Filter pills — Featured is the default; All shows everything flat */}
 	<div class="warp-guide-filters" role="tablist" aria-label="Filter guides by category">
+		{featured.length > 0 && (
+			<button
+				role="tab"
+				aria-selected="true"
+				class="warp-guide-filter-pill active"
+				data-filter="featured"
+			>
+				Featured ({featured.length})
+			</button>
+		)}
 		<button
 			role="tab"
-			aria-selected="true"
-			class="warp-guide-filter-pill active"
+			aria-selected="false"
+			class="warp-guide-filter-pill"
 			data-filter="all"
 		>
 			All ({guides.length})
@@ -80,49 +90,28 @@ const categories = Object.keys(CATEGORY_LABELS).filter((cat) =>
 		})}
 	</div>
 
-	{/* Featured section */}
-	{featured.length > 0 && (
-		<section class="warp-guide-section" data-section="featured">
-			<h2 class="warp-guide-section-heading">Featured</h2>
-			<div class="warp-guide-card-grid">
-				{featured.map((guide) => (
-					<a href={guide.href} class="warp-guide-card" data-category={guide.category}>
-						<span class="warp-guide-card-category">{guide.categoryLabel}</span>
-						<h3 class="warp-guide-card-title">{guide.title}</h3>
-						{guide.description && <p class="warp-guide-card-desc">{guide.description}</p>}
-						{guide.tags.length > 0 && (
-							<div class="warp-guide-card-tags">
-								{guide.tags.map((tag) => (
-									<span class="warp-guide-card-tag">{tag}</span>
-								))}
-							</div>
-						)}
-					</a>
-				))}
-			</div>
-		</section>
-	)}
-
-	{/* All guides */}
-	<section class="warp-guide-section" data-section="all">
-		{featured.length > 0 && <h2 class="warp-guide-section-heading">All guides</h2>}
-		<div class="warp-guide-card-grid">
-			{guides.map((guide) => (
-				<a href={guide.href} class="warp-guide-card" data-category={guide.category}>
-					<span class="warp-guide-card-category">{guide.categoryLabel}</span>
-					<h3 class="warp-guide-card-title">{guide.title}</h3>
-					{guide.description && <p class="warp-guide-card-desc">{guide.description}</p>}
-					{guide.tags.length > 0 && (
-						<div class="warp-guide-card-tags">
-							{guide.tags.map((tag) => (
-								<span class="warp-guide-card-tag">{tag}</span>
-							))}
-						</div>
-					)}
-				</a>
-			))}
-		</div>
-	</section>
+	{/* Single card grid — filtering is handled client-side */}
+	<div class="warp-guide-card-grid">
+		{guides.map((guide) => (
+			<a
+				href={guide.href}
+				class="warp-guide-card"
+				data-category={guide.category}
+				data-featured={guide.featured ? 'true' : undefined}
+			>
+				<span class="warp-guide-card-category">{guide.categoryLabel}</span>
+				<h3 class="warp-guide-card-title">{guide.title}</h3>
+				{guide.description && <p class="warp-guide-card-desc">{guide.description}</p>}
+				{guide.tags.length > 0 && (
+					<div class="warp-guide-card-tags">
+						{guide.tags.map((tag) => (
+							<span class="warp-guide-card-tag">{tag}</span>
+						))}
+					</div>
+				)}
+			</a>
+		))}
+	</div>
 </div>
 
 <script is:inline>
@@ -132,10 +121,7 @@ const categories = Object.keys(CATEGORY_LABELS).filter((cat) =>
 		if (!container) return;
 
 		const pills = container.querySelectorAll('.warp-guide-filter-pill');
-		const featuredSection = container.querySelector('[data-section="featured"]');
-		const allSection = container.querySelector('[data-section="all"]');
-		const allCards = allSection?.querySelectorAll('.warp-guide-card') ?? [];
-		const allHeading = allSection?.querySelector('.warp-guide-section-heading');
+		const cards = container.querySelectorAll('.warp-guide-card');
 
 		pills.forEach((pill) => {
 			pill.addEventListener('click', () => {
@@ -149,25 +135,23 @@ const categories = Object.keys(CATEGORY_LABELS).filter((cat) =>
 				pill.classList.add('active');
 				pill.setAttribute('aria-selected', 'true');
 
-				// Show/hide featured section
-				if (featuredSection) {
-					featuredSection.style.display = filter === 'all' ? '' : 'none';
-				}
-
-				// Show/hide "All guides" heading
-				if (allHeading) {
-					allHeading.style.display = filter === 'all' ? '' : 'none';
-				}
-
 				// Filter cards
-				allCards.forEach((card) => {
-					if (filter === 'all' || card.getAttribute('data-category') === filter) {
-						card.style.display = '';
+				cards.forEach((card) => {
+					let show = false;
+					if (filter === 'all') {
+						show = true;
+					} else if (filter === 'featured') {
+						show = card.hasAttribute('data-featured');
 					} else {
-						card.style.display = 'none';
+						show = card.getAttribute('data-category') === filter;
 					}
+					card.style.display = show ? '' : 'none';
 				});
 			});
 		});
+
+		// Apply initial filter (Featured is default)
+		const defaultPill = container.querySelector('.warp-guide-filter-pill.active');
+		if (defaultPill) defaultPill.click();
 	})();
 </script>
diff --git a/src/styles/custom.css b/src/styles/custom.css
index df3a0590..f23ad9cd 100644
--- a/src/styles/custom.css
+++ b/src/styles/custom.css
@@ -434,6 +434,12 @@ body {
 .warp-guide-card:hover {
   border-color: var(--sl-color-gray-5);
   background: var(--sl-color-gray-6);
+  text-decoration: none;
+}
+
+/* Prevent Starlight's global link underline from cascading into card text */
+.warp-guide-card:hover * {
+  text-decoration: none;
 }
 
 .warp-guide-card-category {

From 61053ed33ec6437525cd1975b6e6f9d125cd9dfc Mon Sep 17 00:00:00 2001
From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com>
Date: Tue, 26 May 2026 11:21:30 -0600
Subject: [PATCH 04/10] fix: tighten card grid for 3-column layout per design
 review

- Reduce grid min-width from 280px to 220px (fits 3 cols in ~730px content area)
- Reduce card padding from 1.25rem to 0.875rem vertical / 1rem horizontal
- Reduce internal card gap from 0.5rem to 0.25rem
- Reduce grid gap from 1rem to 0.75rem
- Shrink title from text-body to text-sm
- Shrink description from text-sm to text-2xs, clamp to 2 lines
- Add tighter line-height on category eyebrow

Co-Authored-By: Oz <oz-agent@warp.dev>
---
 src/styles/custom.css | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/src/styles/custom.css b/src/styles/custom.css
index f23ad9cd..b8fa8009 100644
--- a/src/styles/custom.css
+++ b/src/styles/custom.css
@@ -414,15 +414,16 @@ body {
 
 .warp-guide-card-grid {
   display: grid;
-  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
-  gap: 1rem;
+  /* 220px min allows 3 columns in the ~730px content area beside the sidebar */
+  grid-template-columns: repeat(auto-fill, minmax(220px, 1fr));
+  gap: 0.75rem;
 }
 
 .warp-guide-card {
   display: flex;
   flex-direction: column;
-  gap: 0.5rem;
-  padding: 1.25rem;
+  gap: 0.25rem;
+  padding: 0.875rem 1rem;
   border: 1px solid var(--sl-color-hairline-light);
   border-radius: var(--sl-radius-md);
   background: transparent;
@@ -448,6 +449,7 @@ body {
   color: var(--sl-color-accent);
   text-transform: uppercase;
   letter-spacing: 0.04em;
+  line-height: 1.2;
 }
 
 :root[data-theme='light'] .warp-guide-card-category {
@@ -455,7 +457,7 @@ body {
 }
 
 .warp-guide-card-title {
-  font-size: var(--sl-text-body);
+  font-size: var(--sl-text-sm);
   font-weight: 600;
   color: var(--sl-color-white);
   margin: 0;
@@ -463,12 +465,12 @@ body {
 }
 
 .warp-guide-card-desc {
-  font-size: var(--sl-text-sm);
+  font-size: var(--sl-text-2xs);
   color: var(--sl-color-gray-3);
   margin: 0;
-  line-height: 1.5;
+  line-height: 1.45;
   display: -webkit-box;
-  -webkit-line-clamp: 3;
+  -webkit-line-clamp: 2;
   -webkit-box-orient: vertical;
   overflow: hidden;
 }

From 777dca0d9f29300cef4c122680440ed5a640db63 Mon Sep 17 00:00:00 2001
From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com>
Date: Thu, 28 May 2026 13:07:58 -0600
Subject: [PATCH 05/10] fix: update featured guides based on traffic data

Swap editorially-chosen featured guides for traffic-validated picks:

New featured (6):
- Set up Claude Code (3.7K views)
- Set up Ollama (2.1K views)
- 10 coding features you should know (721 views)
- Run multiple AI coding agents (636 views)
- Review AI-generated code (410 views)
- Using MCP servers with Warp (187 views, integrations gateway)

Removed:
- Explain your codebase (low traffic)
- Run 3 agents in parallel (low traffic)
- Create project rules (low traffic)
- Sentry MCP (low traffic)
- Build a real-time chat app (low traffic)

Co-Authored-By: Oz <oz-agent@warp.dev>
---
 .../how-to-explain-your-codebase-using-warp-rust-codebase.mdx    | 1 -
 .../guides/agent-workflows/how-to-review-ai-generated-code.mdx   | 1 +
 ...-3-agents-in-parallel-summarize-logs-analyze-pr-modify-ui.mdx | 1 -
 .../agent-workflows/how-to-run-multiple-ai-coding-agents.mdx     | 1 +
 .../building-a-real-time-chat-app-github-mcp-railway.mdx         | 1 -
 ...t-rules-for-an-existing-project-astro-typescript-tailwind.mdx | 1 -
 .../docs/guides/external-tools/how-to-set-up-claude-code.mdx     | 1 +
 src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx  | 1 +
 .../sentry-mcp-fix-sentry-error-in-empower-website.mdx           | 1 -
 .../getting-started/10-coding-features-you-should-know.mdx       | 1 +
 10 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/content/docs/guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase.mdx b/src/content/docs/guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase.mdx
index b8bb844f..11afb403 100644
--- a/src/content/docs/guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase.mdx
+++ b/src/content/docs/guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase.mdx
@@ -8,7 +8,6 @@ sidebar:
   label: "Explain your codebase using Warp"
 tags:
   - "agents"
-featured: true
 
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
diff --git a/src/content/docs/guides/agent-workflows/how-to-review-ai-generated-code.mdx b/src/content/docs/guides/agent-workflows/how-to-review-ai-generated-code.mdx
index 2f5db010..073b912d 100644
--- a/src/content/docs/guides/agent-workflows/how-to-review-ai-generated-code.mdx
+++ b/src/content/docs/guides/agent-workflows/how-to-review-ai-generated-code.mdx
@@ -5,6 +5,7 @@ description: >-
   works with Claude Code, Codex, or any CLI agent.
 sidebar:
   label: "Review AI-generated code"
+featured: true
 tags:
   - "agents"
   - "code-review"
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 79273893..85b1ed1e 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
@@ -7,7 +7,6 @@ sidebar:
   label: "Run 3 agents in parallel"
 tags:
   - "agents"
-featured: true
 
 ---
 import { Tabs, TabItem } from '@astrojs/starlight/components';
diff --git a/src/content/docs/guides/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx b/src/content/docs/guides/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx
index f55ee820..7d1f282c 100644
--- a/src/content/docs/guides/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx
+++ b/src/content/docs/guides/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx
@@ -6,6 +6,7 @@ description: >-
   once.
 sidebar:
   label: "Run multiple AI coding agents"
+featured: true
 tags:
   - "agents"
 
diff --git a/src/content/docs/guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway.mdx b/src/content/docs/guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway.mdx
index 39f1196d..1b353a10 100644
--- a/src/content/docs/guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway.mdx
+++ b/src/content/docs/guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway.mdx
@@ -8,7 +8,6 @@ sidebar:
 tags:
   - "build-app"
   - "mcp"
-featured: true
 
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
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 9b46704d..bfe35306 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
@@ -7,7 +7,6 @@ sidebar:
   label: "Create project Rules for an existing project"
 tags:
   - "rules"
-featured: true
 
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
diff --git a/src/content/docs/guides/external-tools/how-to-set-up-claude-code.mdx b/src/content/docs/guides/external-tools/how-to-set-up-claude-code.mdx
index dfd703c3..d047bcb2 100644
--- a/src/content/docs/guides/external-tools/how-to-set-up-claude-code.mdx
+++ b/src/content/docs/guides/external-tools/how-to-set-up-claude-code.mdx
@@ -5,6 +5,7 @@ description: >-
   productivity tips — from voice prompting to visual code review.
 sidebar:
   label: "Set up Claude Code"
+featured: true
 tags:
   - "third-party-tools"
 
diff --git a/src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx b/src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx
index 220d0616..34e0157b 100644
--- a/src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx
+++ b/src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx
@@ -5,6 +5,7 @@ description: >-
   local models into your apps using Warp.
 sidebar:
   label: "Set up Ollama"
+featured: true
 tags:
   - "third-party-tools"
 
diff --git a/src/content/docs/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx b/src/content/docs/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx
index 7284d1d1..a72a6447 100644
--- a/src/content/docs/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx
+++ b/src/content/docs/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx
@@ -7,7 +7,6 @@ sidebar:
   label: "Sentry MCP: fix Sentry error in empower website"
 tags:
   - "mcp"
-featured: true
 
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
diff --git a/src/content/docs/guides/getting-started/10-coding-features-you-should-know.mdx b/src/content/docs/guides/getting-started/10-coding-features-you-should-know.mdx
index 42cfc193..e4b7a259 100644
--- a/src/content/docs/guides/getting-started/10-coding-features-you-should-know.mdx
+++ b/src/content/docs/guides/getting-started/10-coding-features-you-should-know.mdx
@@ -5,6 +5,7 @@ description: >-
   find and replace, syntax highlighting, code review panel, and more.
 sidebar:
   label: "10 coding features you should know"
+featured: true
 tags:
   - "getting-started"
   - "agents"

From 8d187ad1d6203f710e3a6a724f0c9e96e21e9b1c Mon Sep 17 00:00:00 2001
From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com>
Date: Thu, 28 May 2026 13:13:15 -0600
Subject: [PATCH 06/10] feat: switch to use-case categories for guide filter
 pills
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Replace directory-based categories (Getting started, Agent workflows,
Configuration, etc.) with problem/solution use-case categories that
cut across the filesystem structure:

- Set up your environment (9) — first steps + tool installation
- Work with agents (10) — prompting, voice, images, parallel tasks
- Automate your workflow (10) — rules, profiles, prompts, skills
- Connect external services (9) — MCP servers
- Build & deploy apps (9) — app builds, Docker, K8s, cloud, frontend
- Review & debug (7) — PR review, code review, testing, database, secrets

Each guide is mapped to exactly one category via GUIDE_CATEGORIES in
GuidesLanding.astro. New guides need a single entry added to this map.

Co-Authored-By: Oz <oz-agent@warp.dev>
---
 src/components/GuidesLanding.astro | 99 +++++++++++++++++++++++++++---
 1 file changed, 90 insertions(+), 9 deletions(-)

diff --git a/src/components/GuidesLanding.astro b/src/components/GuidesLanding.astro
index e919a757..9e2b2f10 100644
--- a/src/components/GuidesLanding.astro
+++ b/src/components/GuidesLanding.astro
@@ -2,18 +2,99 @@
 // Pure Astro component for the Guides card-based discovery page.
 // Renders the full card grid at build time; a small inline script
 // handles filter-pill interactivity on the client.
+//
+// Categories use a problem/solution (use-case) taxonomy that cuts across
+// the filesystem directory structure. Each guide is assigned to exactly
+// one category via the GUIDE_CATEGORIES map below.
 import { getCollection } from 'astro:content';
 
+// Use-case categories — ordered as they appear in the filter pill bar.
 const CATEGORY_LABELS: Record<string, string> = {
-	'getting-started': 'Getting started',
-	'agent-workflows': 'Agent workflows',
-	configuration: 'Configuration',
-	'external-tools': 'External tools',
-	'build-an-app-in-warp': 'Build an app',
-	devops: 'DevOps',
-	frontend: 'Frontend & UI',
+	setup: 'Set up your environment',
+	agents: 'Work with agents',
+	automate: 'Automate your workflow',
+	connect: 'Connect external services',
+	'build-deploy': 'Build & deploy apps',
+	'review-debug': 'Review & debug',
 };
 
+// Map guide paths (relative to guides/) to use-case categories.
+// Guides not listed here fall back to a directory-based default.
+const GUIDE_CATEGORIES: Record<string, string> = {
+	// Set up your environment — first steps + tool installation
+	'getting-started/welcome-to-warp': 'setup',
+	'getting-started/10-coding-features-you-should-know': 'setup',
+	'getting-started/how-to-customize-warps-appearance': 'setup',
+	'getting-started/how-to-make-warps-ui-more-minimal': 'setup',
+	'external-tools/how-to-set-up-claude-code': 'setup',
+	'external-tools/how-to-set-up-codex-cli': 'setup',
+	'external-tools/how-to-set-up-gemini-cli': 'setup',
+	'external-tools/how-to-set-up-ollama': 'setup',
+	'external-tools/how-to-set-up-opencode': 'setup',
+
+	// Work with agents — prompting, voice, images, parallel tasks
+	'agent-workflows/how-to-run-multiple-ai-coding-agents': 'agents',
+	'agent-workflows/how-to-use-voice-and-images-to-prompt-coding-agents': 'agents',
+	'agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase': 'agents',
+	'agent-workflows/how-to-run-3-agents-in-parallel-summarize-logs-analyze-pr-modify-ui': 'agents',
+	'agent-workflows/how-to-edit-agent-code-in-warp': 'agents',
+	'agent-workflows/using-images-as-context-with-warp': 'agents',
+	'agent-workflows/understanding-your-codebase': 'agents',
+	'agent-workflows/running-multiple-agents-at-once-with-warp': 'agents',
+	'agent-workflows/warp-for-product-managers': 'agents',
+	'agent-workflows/warp-vs-claude-code': 'agents',
+
+	// Automate your workflow — rules, profiles, prompts, skills
+	'configuration/how-to-create-project-rules-for-an-existing-project-astro-typescript-tailwind': 'automate',
+	'configuration/how-to-set-coding-best-practices': 'automate',
+	'configuration/how-to-set-tech-stack-preferences-with-rules': 'automate',
+	'configuration/how-to-set-coding-preferences-with-rules': 'automate',
+	'configuration/how-to-configure-yolo-and-strategic-agent-profiles': 'automate',
+	'configuration/how-to-use-agent-profiles-efficiently': 'automate',
+	'configuration/creating-rules-for-agents': 'automate',
+	'configuration/trigger-reusable-actions-with-saved-prompts': 'automate',
+	'configuration/how-to-set-up-self-serve-data-analytics-with-skills': 'automate',
+	'configuration/how-to-sync-your-monorepos': 'automate',
+
+	// Connect external services — MCP servers
+	'external-tools/sentry-mcp-fix-sentry-error-in-empower-website': 'connect',
+	'external-tools/figma-remote-mcp-create-a-website-from-a-figma-file-from-scratch': 'connect',
+	'external-tools/linear-mcp-retrieve-issue-data': 'connect',
+	'external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach': 'connect',
+	'external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues': 'connect',
+	'external-tools/puppeteer-mcp-scraping-amazon-web-reviews': 'connect',
+	'external-tools/context7-mcp-update-astro-project-with-best-practices': 'connect',
+	'external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up': 'connect',
+	'external-tools/using-mcp-servers-with-warp': 'connect',
+
+	// Build & deploy apps — end-to-end builds, Docker, K8s, cloud, frontend
+	'build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway': 'build-deploy',
+	'build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css': 'build-deploy',
+	'build-an-app-in-warp/building-warps-input-with-warp': 'build-deploy',
+	'build-an-app-in-warp/building-a-slackbot': 'build-deploy',
+	'devops/how-to-analyze-cloud-run-logs-gcloud': 'build-deploy',
+	'devops/how-to-create-a-production-ready-docker-setup': 'build-deploy',
+	'devops/improve-your-kubernetes-workflow-kubectl-helm': 'build-deploy',
+	'frontend/how-to-actually-code-ui-that-matches-your-mockup-react-tailwind': 'build-deploy',
+	'frontend/how-to-replace-a-ui-element-in-warp-rust-codebase': 'build-deploy',
+
+	// Review & debug — PR review, code review, testing, database, secrets
+	'agent-workflows/how-to-review-ai-generated-code': 'review-debug',
+	'agent-workflows/how-to-review-prs-like-a-senior-dev': 'review-debug',
+	'getting-started/how-to-master-warps-code-review-panel': 'review-debug',
+	'devops/how-to-generate-unit-and-security-tests-to-debug-faster': 'review-debug',
+	'devops/how-to-write-sql-commands-inside-a-postgres-repl': 'review-debug',
+	'devops/how-to-create-priority-matrix-for-database-optimization': 'review-debug',
+	'devops/how-to-prevent-secrets-from-leaking': 'review-debug',
+};
+
+/** Resolve a guide's use-case category from its path. */
+function resolveCategory(guideId: string): string {
+	// Strip 'guides/' prefix and file extension to get the lookup key
+	const key = guideId.replace(/^guides\//, '').replace(/\.mdx?$/, '');
+	return GUIDE_CATEGORIES[key] || 'agents'; // fallback
+}
+
 const allDocs = await getCollection('docs', (entry) =>
 	entry.id.startsWith('guides/') && entry.id !== 'guides' && !entry.id.endsWith('/index'),
 );
@@ -34,7 +115,7 @@ const guides: GuideData[] = allDocs
 		return parts.length >= 2;
 	})
 	.map((doc) => {
-		const category = doc.id.replace(/^guides\//, '').split('/')[0];
+		const category = resolveCategory(doc.id);
 		return {
 			title: (doc.data as any).sidebar?.label || doc.data.title,
 			description: doc.data.description || '',
@@ -48,7 +129,7 @@ const guides: GuideData[] = allDocs
 
 const featured = guides.filter((g) => g.featured);
 
-// Derive ordered categories
+// Derive ordered categories (preserving CATEGORY_LABELS order)
 const categories = Object.keys(CATEGORY_LABELS).filter((cat) =>
 	guides.some((g) => g.category === cat),
 );

From 754f8d530017f747a02dece383d83f93679d5ca9 Mon Sep 17 00:00:00 2001
From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com>
Date: Thu, 28 May 2026 13:25:21 -0600
Subject: [PATCH 07/10] style: normalize guide titles and sidebar labels to
 sentence case
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Standardize all 54 guide page titles and sidebar labels per the
docs style guide (sentence case, proper feature names preserved):

- 'How To:' / 'How to:' / 'How To' → 'How to' (no colon, consistent)
- Title Case words → lowercase (except product names)
- Preserved: Warp, Claude Code, Codex CLI, Gemini CLI, OpenCode,
  Ollama, MCP, Docker, Kubernetes, SQL, Postgres, REPL, GitHub,
  Linear, Sentry, Figma, Chrome, Slackbot, Rules, Skills,
  Agent Profiles, Code Review, Cloud Run, YOLO, Astro, React,
  Tailwind, Rust, D3.js, JavaScript, HTML, CSS, Railway
- Fixed 'Javascript' → 'JavaScript' in Chrome extension title
- Updated both frontmatter titles and sidebar.ts labels

Co-Authored-By: Oz <oz-agent@warp.dev>
---
 .../how-to-edit-agent-code-in-warp.mdx        |   4 +-
 ...your-codebase-using-warp-rust-codebase.mdx |   2 +-
 .../how-to-review-prs-like-a-senior-dev.mdx   |   2 +-
 ...el-summarize-logs-analyze-pr-modify-ui.mdx |   2 +-
 ...ning-multiple-agents-at-once-with-warp.mdx |   2 +-
 .../understanding-your-codebase.mdx           |   2 +-
 .../using-images-as-context-with-warp.mdx     |   2 +-
 ...ome-extension-d3js-javascript-html-css.mdx |   2 +-
 ...-real-time-chat-app-github-mcp-railway.mdx |   2 +-
 .../building-warps-input-with-warp.mdx        |   2 +-
 .../creating-rules-for-agents.mdx             |   4 +-
 ...gure-yolo-and-strategic-agent-profiles.mdx |   2 +-
 ...ting-project-astro-typescript-tailwind.mdx |   2 +-
 .../how-to-set-coding-best-practices.mdx      |   2 +-
 ...w-to-set-coding-preferences-with-rules.mdx |   2 +-
 ...-set-tech-stack-preferences-with-rules.mdx |   2 +-
 .../how-to-sync-your-monorepos.mdx            |   2 +-
 .../how-to-use-agent-profiles-efficiently.mdx |   2 +-
 ...er-reusable-actions-with-saved-prompts.mdx |   2 +-
 .../how-to-analyze-cloud-run-logs-gcloud.mdx  |   4 +-
 ...create-a-production-ready-docker-setup.mdx |   2 +-
 ...ority-matrix-for-database-optimization.mdx |   2 +-
 ...nit-and-security-tests-to-debug-faster.mdx |   2 +-
 .../how-to-prevent-secrets-from-leaking.mdx   |   2 +-
 ...te-sql-commands-inside-a-postgres-repl.mdx |   2 +-
 ...-your-kubernetes-workflow-kubectl-helm.mdx |   2 +-
 ...date-astro-project-with-best-practices.mdx |   2 +-
 ...website-from-a-figma-file-from-scratch.mdx |   2 +-
 ...rizing-open-prs-and-creating-gh-issues.mdx |   2 +-
 .../external-tools/how-to-set-up-ollama.mdx   |   2 +-
 .../linear-mcp-retrieve-issue-data.mdx        |   2 +-
 ...ing-tickets-with-a-lean-build-approach.mdx |   2 +-
 ...peteer-mcp-scraping-amazon-web-reviews.mdx |   2 +-
 ...cp-fix-sentry-error-in-empower-website.mdx |   2 +-
 ...asic-queries-you-can-make-after-set-up.mdx |   2 +-
 .../using-mcp-servers-with-warp.mdx           |   4 +-
 ...hat-matches-your-mockup-react-tailwind.mdx |   4 +-
 ...ace-a-ui-element-in-warp-rust-codebase.mdx |   2 +-
 .../10-coding-features-you-should-know.mdx    |   2 +-
 .../how-to-customize-warps-appearance.mdx     |   2 +-
 .../how-to-master-warps-code-review-panel.mdx |   2 +-
 src/sidebar.ts                                | 102 +++++++++---------
 42 files changed, 97 insertions(+), 97 deletions(-)

diff --git a/src/content/docs/guides/agent-workflows/how-to-edit-agent-code-in-warp.mdx b/src/content/docs/guides/agent-workflows/how-to-edit-agent-code-in-warp.mdx
index 381734dd..1f4ff80c 100644
--- a/src/content/docs/guides/agent-workflows/how-to-edit-agent-code-in-warp.mdx
+++ b/src/content/docs/guides/agent-workflows/how-to-edit-agent-code-in-warp.mdx
@@ -1,10 +1,10 @@
 ---
-title: "How to: Edit Agent Code in Warp"
+title: "How to edit agent code in Warp"
 description: >-
   Review, edit, and refine AI-generated code diffs directly in Warp — accept,
   reject, or modify changes before applying them.
 sidebar:
-  label: "Edit Agent code in Warp"
+  label: "Edit agent code in Warp"
 tags:
   - "agents"
 
diff --git a/src/content/docs/guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase.mdx b/src/content/docs/guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase.mdx
index 11afb403..6f6e606c 100644
--- a/src/content/docs/guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase.mdx
+++ b/src/content/docs/guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to: Explain Your Codebase Using Warp (Rust Codebase)"
+title: "How to explain your codebase using Warp (Rust codebase)"
 description: >-
   Use Warp's coding agents with semantic and symbol search to explore,
   understand, and modify unfamiliar codebases — demonstrated on a large Rust
diff --git a/src/content/docs/guides/agent-workflows/how-to-review-prs-like-a-senior-dev.mdx b/src/content/docs/guides/agent-workflows/how-to-review-prs-like-a-senior-dev.mdx
index 6b86b129..d8599ff5 100644
--- a/src/content/docs/guides/agent-workflows/how-to-review-prs-like-a-senior-dev.mdx
+++ b/src/content/docs/guides/agent-workflows/how-to-review-prs-like-a-senior-dev.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How To: Review PRs Like A Senior Dev"
+title: "How to review PRs like a senior dev"
 description: >-
   Prompt Warp's coding agent to generate structured PR reviews with risk
   assessment, critical issues, and merge confidence scoring.
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 85b1ed1e..afb89655 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"
+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/agent-workflows/running-multiple-agents-at-once-with-warp.mdx b/src/content/docs/guides/agent-workflows/running-multiple-agents-at-once-with-warp.mdx
index ef35f7ea..a9077ae7 100644
--- a/src/content/docs/guides/agent-workflows/running-multiple-agents-at-once-with-warp.mdx
+++ b/src/content/docs/guides/agent-workflows/running-multiple-agents-at-once-with-warp.mdx
@@ -1,5 +1,5 @@
 ---
-title: Running Multiple Agents At Once With Warp
+title: Running multiple agents at once with Warp
 description: >-
   Run multiple agent tasks simultaneously in Warp — revert PRs, edit
   shortcuts, and add tests across repos without losing context.
diff --git a/src/content/docs/guides/agent-workflows/understanding-your-codebase.mdx b/src/content/docs/guides/agent-workflows/understanding-your-codebase.mdx
index 4eb2452e..724607e4 100644
--- a/src/content/docs/guides/agent-workflows/understanding-your-codebase.mdx
+++ b/src/content/docs/guides/agent-workflows/understanding-your-codebase.mdx
@@ -1,5 +1,5 @@
 ---
-title: Understanding Your Codebase
+title: Understanding your codebase
 description: >-
   Use Warp's Codebase Context to search across client and server repos,
   generate architecture summaries, and onboard to unfamiliar features fast.
diff --git a/src/content/docs/guides/agent-workflows/using-images-as-context-with-warp.mdx b/src/content/docs/guides/agent-workflows/using-images-as-context-with-warp.mdx
index 912eea0d..9b5ce0f5 100644
--- a/src/content/docs/guides/agent-workflows/using-images-as-context-with-warp.mdx
+++ b/src/content/docs/guides/agent-workflows/using-images-as-context-with-warp.mdx
@@ -1,5 +1,5 @@
 ---
-title: Using Images As Context With Warp
+title: Using images as context with Warp
 description: >-
   Attach screenshots and design mockups as context for Warp's agent to
   generate UI code, debug visual issues, and match Figma designs.
diff --git a/src/content/docs/guides/build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css.mdx b/src/content/docs/guides/build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css.mdx
index d2d97dbc..b7db7849 100644
--- a/src/content/docs/guides/build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css.mdx
+++ b/src/content/docs/guides/build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css.mdx
@@ -1,5 +1,5 @@
 ---
-title: Building a Chrome Extension (D3.js + Javascript + HTML + CSS)
+title: Building a Chrome extension (D3.js + JavaScript + HTML + CSS)
 description: >-
   Build a D3.js Sankey diagram Chrome extension using Warp — scaffold, debug,
   coordinate multiple agents, and publish to the Chrome Web Store.
diff --git a/src/content/docs/guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway.mdx b/src/content/docs/guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway.mdx
index 1b353a10..9fa1937d 100644
--- a/src/content/docs/guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway.mdx
+++ b/src/content/docs/guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway.mdx
@@ -1,5 +1,5 @@
 ---
-title: Building a Real-time Chat App (GitHub MCP + Railway)
+title: Building a real-time chat app (GitHub MCP + Railway)
 description: >-
   Build and deploy a real-time chat app with Python, FastAPI, and JavaScript —
   from idea to production, all inside Warp.
diff --git a/src/content/docs/guides/build-an-app-in-warp/building-warps-input-with-warp.mdx b/src/content/docs/guides/build-an-app-in-warp/building-warps-input-with-warp.mdx
index 2661f526..858c9588 100644
--- a/src/content/docs/guides/build-an-app-in-warp/building-warps-input-with-warp.mdx
+++ b/src/content/docs/guides/build-an-app-in-warp/building-warps-input-with-warp.mdx
@@ -1,5 +1,5 @@
 ---
-title: Building Warp's Input - With Warp
+title: Building Warp's input with Warp
 description: >-
   Watch how a Warp designer uses Warp's own agent to locate, modify, and test
   a UI component change in a large Rust codebase.
diff --git a/src/content/docs/guides/configuration/creating-rules-for-agents.mdx b/src/content/docs/guides/configuration/creating-rules-for-agents.mdx
index 69a10fce..e597b2be 100644
--- a/src/content/docs/guides/configuration/creating-rules-for-agents.mdx
+++ b/src/content/docs/guides/configuration/creating-rules-for-agents.mdx
@@ -1,10 +1,10 @@
 ---
-title: Creating Rules For Agents
+title: Creating Rules for agents
 description: >-
   Create reusable Rules in Warp to encode team conventions — like Dockerfile
   patterns or dependency management — so agents follow your standards.
 sidebar:
-  label: "Create Rules for Agents"
+  label: "Create Rules for agents"
 tags:
   - "rules"
 
diff --git a/src/content/docs/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx b/src/content/docs/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx
index f91f0fb0..5a3d1dd3 100644
--- a/src/content/docs/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx
+++ b/src/content/docs/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How To: Configure YOLO and Strategic Agent Profiles"
+title: "How to configure YOLO and strategic Agent Profiles"
 description: >-
   Configure custom agent profiles in Warp to control planning depth, autonomy,
   and execution speed — demonstrated with YOLO and Strategic examples.
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 bfe35306..fab786ac 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"
+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/configuration/how-to-set-coding-best-practices.mdx b/src/content/docs/guides/configuration/how-to-set-coding-best-practices.mdx
index bca70e0b..8f88b5ab 100644
--- a/src/content/docs/guides/configuration/how-to-set-coding-best-practices.mdx
+++ b/src/content/docs/guides/configuration/how-to-set-coding-best-practices.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How To: Set Coding Best Practices"
+title: "How to set coding best practices"
 description: >-
   Use Warp Rules to enforce coding style, TypeScript conventions, and
   documentation quality across AI-generated code.
diff --git a/src/content/docs/guides/configuration/how-to-set-coding-preferences-with-rules.mdx b/src/content/docs/guides/configuration/how-to-set-coding-preferences-with-rules.mdx
index 5e33e574..fd128ea4 100644
--- a/src/content/docs/guides/configuration/how-to-set-coding-preferences-with-rules.mdx
+++ b/src/content/docs/guides/configuration/how-to-set-coding-preferences-with-rules.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How To: Set Coding Preferences with Rules"
+title: "How to set coding preferences with Rules"
 description: >-
   Store your package manager, environment tool, and CLI preferences as Warp
   Rules so agents automatically use pnpm, miniconda, or your preferred tools.
diff --git a/src/content/docs/guides/configuration/how-to-set-tech-stack-preferences-with-rules.mdx b/src/content/docs/guides/configuration/how-to-set-tech-stack-preferences-with-rules.mdx
index 968f4d43..5a1a91b6 100644
--- a/src/content/docs/guides/configuration/how-to-set-tech-stack-preferences-with-rules.mdx
+++ b/src/content/docs/guides/configuration/how-to-set-tech-stack-preferences-with-rules.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How To: Set Tech Stack Preferences with Rules"
+title: "How to set tech stack preferences with Rules"
 description: >-
   Define your preferred frameworks and tech stack in Warp Rules so agents
   consistently use Astro, SvelteKit, Vite, or your tools of choice.
diff --git a/src/content/docs/guides/configuration/how-to-sync-your-monorepos.mdx b/src/content/docs/guides/configuration/how-to-sync-your-monorepos.mdx
index ec589421..b27e2206 100644
--- a/src/content/docs/guides/configuration/how-to-sync-your-monorepos.mdx
+++ b/src/content/docs/guides/configuration/how-to-sync-your-monorepos.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How To: Sync Your Monorepos"
+title: "How to sync your monorepos"
 description: >-
   Define global Rules in Warp to keep monorepo schemas, server types, and
   client types automatically synchronized across repositories.
diff --git a/src/content/docs/guides/configuration/how-to-use-agent-profiles-efficiently.mdx b/src/content/docs/guides/configuration/how-to-use-agent-profiles-efficiently.mdx
index 391dee54..22e947e3 100644
--- a/src/content/docs/guides/configuration/how-to-use-agent-profiles-efficiently.mdx
+++ b/src/content/docs/guides/configuration/how-to-use-agent-profiles-efficiently.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How To: Use Agent Profiles Efficiently"
+title: "How to use Agent Profiles efficiently"
 description: >-
   Compare Strategic and YOLO agent profiles side-by-side to choose the right
   balance of planning, safety, and speed for your project.
diff --git a/src/content/docs/guides/configuration/trigger-reusable-actions-with-saved-prompts.mdx b/src/content/docs/guides/configuration/trigger-reusable-actions-with-saved-prompts.mdx
index 5a5f5e18..184faf72 100644
--- a/src/content/docs/guides/configuration/trigger-reusable-actions-with-saved-prompts.mdx
+++ b/src/content/docs/guides/configuration/trigger-reusable-actions-with-saved-prompts.mdx
@@ -1,5 +1,5 @@
 ---
-title: Trigger Reusable Actions With Saved Prompts
+title: Trigger reusable actions with saved prompts
 description: >-
   Save and share prompts in Warp Drive to automate commits, code reviews, and
   PR creation across your team.
diff --git a/src/content/docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx b/src/content/docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx
index a1b73978..bc1fd289 100644
--- a/src/content/docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx
+++ b/src/content/docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx
@@ -1,10 +1,10 @@
 ---
-title: "How to: Analyze Cloud Run Logs (gcloud)"
+title: "How to analyze Cloud Run logs (gcloud)"
 description: >-
   Use Warp to pull, organize, and analyze Cloud Run production logs by
   severity with natural language prompts and automated Python scripts.
 sidebar:
-  label: "Analyze cloud run logs"
+  label: "Analyze Cloud Run logs"
 tags:
   - "cloud"
 
diff --git a/src/content/docs/guides/devops/how-to-create-a-production-ready-docker-setup.mdx b/src/content/docs/guides/devops/how-to-create-a-production-ready-docker-setup.mdx
index a516335b..f3503961 100644
--- a/src/content/docs/guides/devops/how-to-create-a-production-ready-docker-setup.mdx
+++ b/src/content/docs/guides/devops/how-to-create-a-production-ready-docker-setup.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How To: Create a Production Ready Docker Setup"
+title: "How to create a production-ready Docker setup"
 description: >-
   Use Agents in Warp to generate optimized Dockerfiles, docker-compose
   configs, and .dockerignore files for multi-stage production deployments.
diff --git a/src/content/docs/guides/devops/how-to-create-priority-matrix-for-database-optimization.mdx b/src/content/docs/guides/devops/how-to-create-priority-matrix-for-database-optimization.mdx
index 7caf02cb..3a173e7d 100644
--- a/src/content/docs/guides/devops/how-to-create-priority-matrix-for-database-optimization.mdx
+++ b/src/content/docs/guides/devops/how-to-create-priority-matrix-for-database-optimization.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How To: Create Priority Matrix for Database Optimization"
+title: "How to create a priority matrix for database optimization"
 description: >-
   Prompt Warp to audit SQL queries, analyze execution plans, and generate a
   priority matrix ranking database optimizations by impact and effort.
diff --git a/src/content/docs/guides/devops/how-to-generate-unit-and-security-tests-to-debug-faster.mdx b/src/content/docs/guides/devops/how-to-generate-unit-and-security-tests-to-debug-faster.mdx
index 572d7a47..96a7fe68 100644
--- a/src/content/docs/guides/devops/how-to-generate-unit-and-security-tests-to-debug-faster.mdx
+++ b/src/content/docs/guides/devops/how-to-generate-unit-and-security-tests-to-debug-faster.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to: Generate Unit and Security Tests to Debug Faster"
+title: "How to generate unit and security tests to debug faster"
 description: >-
   Prompt Warp to generate comprehensive unit and security tests for REST APIs,
   including SQL injection, XSS, and auth validation checks.
diff --git a/src/content/docs/guides/devops/how-to-prevent-secrets-from-leaking.mdx b/src/content/docs/guides/devops/how-to-prevent-secrets-from-leaking.mdx
index 1f411833..fed9e466 100644
--- a/src/content/docs/guides/devops/how-to-prevent-secrets-from-leaking.mdx
+++ b/src/content/docs/guides/devops/how-to-prevent-secrets-from-leaking.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How To: Prevent Secrets from Leaking"
+title: "How to prevent secrets from leaking"
 description: >-
   Use Warp Rules and built-in secret reduction to prevent API keys and
   credentials from leaking in agent output, demos, and shared sessions.
diff --git a/src/content/docs/guides/devops/how-to-write-sql-commands-inside-a-postgres-repl.mdx b/src/content/docs/guides/devops/how-to-write-sql-commands-inside-a-postgres-repl.mdx
index e8a24955..5149370b 100644
--- a/src/content/docs/guides/devops/how-to-write-sql-commands-inside-a-postgres-repl.mdx
+++ b/src/content/docs/guides/devops/how-to-write-sql-commands-inside-a-postgres-repl.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How To: Write SQL Commands inside a Postgres REPL"
+title: "How to write SQL commands inside a Postgres REPL"
 description: >-
   Use Agents in Warp inside a Postgres REPL to translate natural language into
   SQL queries — works with Node.js, Python, and MySQL too.
diff --git a/src/content/docs/guides/devops/improve-your-kubernetes-workflow-kubectl-helm.mdx b/src/content/docs/guides/devops/improve-your-kubernetes-workflow-kubectl-helm.mdx
index 5b652215..47960225 100644
--- a/src/content/docs/guides/devops/improve-your-kubernetes-workflow-kubectl-helm.mdx
+++ b/src/content/docs/guides/devops/improve-your-kubernetes-workflow-kubectl-helm.mdx
@@ -1,5 +1,5 @@
 ---
-title: Improve Your Kubernetes Workflow (kubectl + helm)
+title: Improve your Kubernetes workflow (kubectl + Helm)
 description: >-
   Streamline kubectl and Helm workflows with Warp's AI assistance, active
   suggestions, custom workflows, and synchronized panes.
diff --git a/src/content/docs/guides/external-tools/context7-mcp-update-astro-project-with-best-practices.mdx b/src/content/docs/guides/external-tools/context7-mcp-update-astro-project-with-best-practices.mdx
index 2114ba8a..16c4a667 100644
--- a/src/content/docs/guides/external-tools/context7-mcp-update-astro-project-with-best-practices.mdx
+++ b/src/content/docs/guides/external-tools/context7-mcp-update-astro-project-with-best-practices.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Context7 MCP: Update Astro Project with Best Practices"
+title: "Context7 MCP: update Astro project with best practices"
 description: >-
   Use the Context7 MCP server to give Warp agents real-time access to
   framework documentation for automated project upgrades.
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 e9a3c4d5..4d9c0419 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"
+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/external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues.mdx b/src/content/docs/guides/external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues.mdx
index b002364b..a5b6f6b1 100644
--- a/src/content/docs/guides/external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues.mdx
+++ b/src/content/docs/guides/external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues.mdx
@@ -1,5 +1,5 @@
 ---
-title: "GitHub MCP: Summarizing Open PRs & Creating GH Issues"
+title: "GitHub MCP: summarize open PRs and create GitHub issues"
 description: >-
   Connect the GitHub MCP server to Warp to summarize open PRs, create issues
   from TODO comments, and automate repo management.
diff --git a/src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx b/src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx
index 34e0157b..35b2a024 100644
--- a/src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx
+++ b/src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx
@@ -1,5 +1,5 @@
 ---
-title: How To Set Up Ollama
+title: How to set up Ollama
 description: >-
   Install Ollama, run LLMs locally, compare model performance, and integrate
   local models into your apps using Warp.
diff --git a/src/content/docs/guides/external-tools/linear-mcp-retrieve-issue-data.mdx b/src/content/docs/guides/external-tools/linear-mcp-retrieve-issue-data.mdx
index 2cf4465e..5f781e4f 100644
--- a/src/content/docs/guides/external-tools/linear-mcp-retrieve-issue-data.mdx
+++ b/src/content/docs/guides/external-tools/linear-mcp-retrieve-issue-data.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Linear MCP: Retrieve issue data"
+title: "Linear MCP: retrieve issue data"
 description: >-
   Add the Linear MCP server to Warp and query your issues, tasks, and
   assignments directly from the terminal.
diff --git a/src/content/docs/guides/external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach.mdx b/src/content/docs/guides/external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach.mdx
index 1494f01c..9fdefa54 100644
--- a/src/content/docs/guides/external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach.mdx
+++ b/src/content/docs/guides/external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Linear MCP: Updating Tickets with a Lean Build Approach"
+title: "Linear MCP: update tickets with a lean build approach"
 description: >-
   Use Warp's Linear MCP integration to update ticket descriptions, propagate
   changes to subtasks, and maintain a lean build strategy.
diff --git a/src/content/docs/guides/external-tools/puppeteer-mcp-scraping-amazon-web-reviews.mdx b/src/content/docs/guides/external-tools/puppeteer-mcp-scraping-amazon-web-reviews.mdx
index 5f3a47d5..9194f968 100644
--- a/src/content/docs/guides/external-tools/puppeteer-mcp-scraping-amazon-web-reviews.mdx
+++ b/src/content/docs/guides/external-tools/puppeteer-mcp-scraping-amazon-web-reviews.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Puppeteer MCP: Scraping Amazon Web Reviews"
+title: "Puppeteer MCP: scrape Amazon web reviews"
 description: >-
   Configure the Puppeteer MCP server in Warp to automate browser tasks like
   navigating sites, scraping product data, and analyzing reviews.
diff --git a/src/content/docs/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx b/src/content/docs/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx
index a72a6447..f26bc5d1 100644
--- a/src/content/docs/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx
+++ b/src/content/docs/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Sentry MCP: Fix Sentry Error in Empower Website"
+title: "Sentry MCP: fix Sentry error in Empower website"
 description: >-
   Connect the Sentry MCP server to Warp, fetch live error data, diagnose stack
   traces, and auto-generate fixes for production issues.
diff --git a/src/content/docs/guides/external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up.mdx b/src/content/docs/guides/external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up.mdx
index c775640a..cdf8a595 100644
--- a/src/content/docs/guides/external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up.mdx
+++ b/src/content/docs/guides/external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up.mdx
@@ -1,5 +1,5 @@
 ---
-title: "SQLite and Stripe MCP: Basic Queries You Can Make After Set Up"
+title: "SQLite and Stripe MCP: basic queries you can make after setup"
 description: >-
   Connect SQLite and Stripe MCP servers to Warp and run conversational queries
   against your local database and payment data.
diff --git a/src/content/docs/guides/external-tools/using-mcp-servers-with-warp.mdx b/src/content/docs/guides/external-tools/using-mcp-servers-with-warp.mdx
index 58037ac6..21a7379b 100644
--- a/src/content/docs/guides/external-tools/using-mcp-servers-with-warp.mdx
+++ b/src/content/docs/guides/external-tools/using-mcp-servers-with-warp.mdx
@@ -1,10 +1,10 @@
 ---
-title: Using MCP Servers with Warp
+title: Using MCP servers with Warp
 description: >-
   Connect MCP servers to Warp's agent, add Rules for automatic tool selection,
   and resolve tickets using external systems like Linear.
 sidebar:
-  label: "Connect Agents to MCP servers"
+  label: "Connect agents to MCP servers"
 tags:
   - "mcp"
 featured: true
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 1b2b3e1f..41b969b9 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,10 +1,10 @@
 ---
-title: "How To: Code UI That Matches Your Mockup"
+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.
 sidebar:
-  label: "Actually code UI that matches your mockup"
+  label: "Code UI that matches your mockup"
 tags:
   - "frontend"
 
diff --git a/src/content/docs/guides/frontend/how-to-replace-a-ui-element-in-warp-rust-codebase.mdx b/src/content/docs/guides/frontend/how-to-replace-a-ui-element-in-warp-rust-codebase.mdx
index 9a0d7161..af3bf200 100644
--- a/src/content/docs/guides/frontend/how-to-replace-a-ui-element-in-warp-rust-codebase.mdx
+++ b/src/content/docs/guides/frontend/how-to-replace-a-ui-element-in-warp-rust-codebase.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How To: Replace A UI Element in Warp (Rust Codebase)"
+title: "How to replace a UI element in Warp (Rust codebase)"
 description: >-
   Use Agent Mode in Warp to plan and execute icon replacements across a large
   Rust codebase — with live diffs, auto-compilation, and self-correction.
diff --git a/src/content/docs/guides/getting-started/10-coding-features-you-should-know.mdx b/src/content/docs/guides/getting-started/10-coding-features-you-should-know.mdx
index e4b7a259..bf15dc86 100644
--- a/src/content/docs/guides/getting-started/10-coding-features-you-should-know.mdx
+++ b/src/content/docs/guides/getting-started/10-coding-features-you-should-know.mdx
@@ -1,5 +1,5 @@
 ---
-title: 10 Coding Features You Should Know
+title: 10 coding features you should know
 description: >-
   Discover 10 essential coding features in Warp — file search, tabbed editor,
   find and replace, syntax highlighting, code review panel, and more.
diff --git a/src/content/docs/guides/getting-started/how-to-customize-warps-appearance.mdx b/src/content/docs/guides/getting-started/how-to-customize-warps-appearance.mdx
index 370be2a9..f30c22b5 100644
--- a/src/content/docs/guides/getting-started/how-to-customize-warps-appearance.mdx
+++ b/src/content/docs/guides/getting-started/how-to-customize-warps-appearance.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to: Customize Warp's Appearance"
+title: "How to customize Warp's appearance"
 description: >-
   Customize Warp's themes, input placement, AI settings, codebase indexing,
   team collaboration, and visual appearance to fit your workflow.
diff --git a/src/content/docs/guides/getting-started/how-to-master-warps-code-review-panel.mdx b/src/content/docs/guides/getting-started/how-to-master-warps-code-review-panel.mdx
index 2f33c0b6..9214ff99 100644
--- a/src/content/docs/guides/getting-started/how-to-master-warps-code-review-panel.mdx
+++ b/src/content/docs/guides/getting-started/how-to-master-warps-code-review-panel.mdx
@@ -1,5 +1,5 @@
 ---
-title: How To Master Warp's Code Review Panel
+title: How to master Warp's Code Review panel
 description: >-
   Use Warp's Code Review Panel to view file diffs, edit code inline,
   componentize changes, and commit directly — all without leaving the
diff --git a/src/sidebar.ts b/src/sidebar.ts
index 3b22938b..0ea54006 100644
--- a/src/sidebar.ts
+++ b/src/sidebar.ts
@@ -617,72 +617,72 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
 					collapsed: true,
 					items: [
 						'guides/getting-started/welcome-to-warp',
-						{ slug: 'guides/getting-started/10-coding-features-you-should-know', label: '10 Warp Coding Features You Should Know' },
-						{ slug: 'guides/getting-started/how-to-customize-warps-appearance', label: 'Customize Warp\'s Appearance' },
-						{ slug: 'guides/getting-started/how-to-make-warps-ui-more-minimal', label: 'Make Warp\'s UI More Minimal' },
-						{ slug: 'guides/getting-started/how-to-master-warps-code-review-panel', label: 'Master Warp\'s Code Review Panel' },
+				{ slug: 'guides/getting-started/10-coding-features-you-should-know', label: '10 coding features you should know' },
+						{ slug: 'guides/getting-started/how-to-customize-warps-appearance', label: 'Customize Warp\'s appearance' },
+						{ slug: 'guides/getting-started/how-to-make-warps-ui-more-minimal', label: 'Make Warp\'s UI more minimal' },
+						{ slug: 'guides/getting-started/how-to-master-warps-code-review-panel', label: 'Master Warp\'s Code Review panel' },
 					],
 				},
 				{
 					label: 'Agent workflows',
 					collapsed: true,
 					items: [
-						{ slug: 'guides/agent-workflows/how-to-review-ai-generated-code', label: 'Review AI-Generated Code' },
-						{ slug: 'guides/agent-workflows/how-to-run-multiple-ai-coding-agents', label: 'Run Multiple AI Coding Agents' },
-						{ slug: 'guides/agent-workflows/how-to-use-voice-and-images-to-prompt-coding-agents', label: 'Use Voice and Images to Prompt Agents' },
-						{ slug: 'guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase', label: 'Explain Your Codebase with Agents' },
-						{ slug: 'guides/agent-workflows/warp-for-product-managers', label: '5 AI Agent Workflows for Product Managers' },
-						{ slug: 'guides/agent-workflows/how-to-run-3-agents-in-parallel-summarize-logs-analyze-pr-modify-ui', label: 'Run Tasks in Parallel' },
-						{ slug: 'guides/agent-workflows/how-to-edit-agent-code-in-warp', label: 'Edit Agent-Generated Code in Warp' },
-						{ slug: 'guides/agent-workflows/how-to-review-prs-like-a-senior-dev', label: 'Review PRs Like a Senior Dev' },
-						{ slug: 'guides/agent-workflows/using-images-as-context-with-warp', label: 'Use Images as Context for Agents' },
-						{ slug: 'guides/agent-workflows/understanding-your-codebase', label: 'Understand a Large Codebase with Agents' },
-						{ slug: 'guides/agent-workflows/running-multiple-agents-at-once-with-warp', label: 'Coordinate Agents on Separate Tasks' },
+						{ slug: 'guides/agent-workflows/how-to-review-ai-generated-code', label: 'Review AI-generated code' },
+						{ slug: 'guides/agent-workflows/how-to-run-multiple-ai-coding-agents', label: 'Run multiple AI coding agents' },
+						{ slug: 'guides/agent-workflows/how-to-use-voice-and-images-to-prompt-coding-agents', label: 'Use voice and images to prompt agents' },
+						{ slug: 'guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase', label: 'Explain your codebase with agents' },
+						{ slug: 'guides/agent-workflows/warp-for-product-managers', label: '5 agent workflows for product managers' },
+						{ slug: 'guides/agent-workflows/how-to-run-3-agents-in-parallel-summarize-logs-analyze-pr-modify-ui', label: 'Run tasks in parallel' },
+						{ slug: 'guides/agent-workflows/how-to-edit-agent-code-in-warp', label: 'Edit agent-generated code in Warp' },
+						{ slug: 'guides/agent-workflows/how-to-review-prs-like-a-senior-dev', label: 'Review PRs like a senior dev' },
+						{ slug: 'guides/agent-workflows/using-images-as-context-with-warp', label: 'Use images as context for agents' },
+						{ slug: 'guides/agent-workflows/understanding-your-codebase', label: 'Understand a large codebase with agents' },
+						{ slug: 'guides/agent-workflows/running-multiple-agents-at-once-with-warp', label: 'Coordinate agents on separate tasks' },
 					],
 				},
 				{
 					label: 'Configuration',
 					collapsed: true,
 					items: [
-						{ slug: 'guides/configuration/how-to-create-project-rules-for-an-existing-project-astro-typescript-tailwind', label: 'Create Project Rules' },
-						{ slug: 'guides/configuration/how-to-set-coding-best-practices', label: 'Set Coding Best Practices with Rules' },
-						{ slug: 'guides/configuration/how-to-set-tech-stack-preferences-with-rules', label: 'Set Tech Stack Preferences with Rules' },
-						{ slug: 'guides/configuration/how-to-set-coding-preferences-with-rules', label: 'Set Coding Preferences with Rules' },
-						{ slug: 'guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles', label: 'Configure Agent Profiles (YOLO & Strategic)' },
-						{ slug: 'guides/configuration/how-to-use-agent-profiles-efficiently', label: 'Use Agent Profiles Efficiently' },
-						{ slug: 'guides/configuration/creating-rules-for-agents', label: 'Create Reusable Rules for Your Team' },
-						{ slug: 'guides/configuration/trigger-reusable-actions-with-saved-prompts', label: 'Trigger Reusable Actions with Saved Prompts' },
-						{ slug: 'guides/configuration/how-to-set-up-self-serve-data-analytics-with-skills', label: 'Set Up Self-Serve Data Analytics with Skills' },
-						{ slug: 'guides/configuration/how-to-sync-your-monorepos', label: 'Sync Your Monorepos' },
+						{ slug: 'guides/configuration/how-to-create-project-rules-for-an-existing-project-astro-typescript-tailwind', label: 'Create project Rules' },
+						{ slug: 'guides/configuration/how-to-set-coding-best-practices', label: 'Set coding best practices with Rules' },
+						{ slug: 'guides/configuration/how-to-set-tech-stack-preferences-with-rules', label: 'Set tech stack preferences with Rules' },
+						{ slug: 'guides/configuration/how-to-set-coding-preferences-with-rules', label: 'Set coding preferences with Rules' },
+						{ slug: 'guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles', label: 'Configure Agent Profiles (YOLO & strategic)' },
+						{ slug: 'guides/configuration/how-to-use-agent-profiles-efficiently', label: 'Use Agent Profiles efficiently' },
+						{ slug: 'guides/configuration/creating-rules-for-agents', label: 'Create reusable Rules for your team' },
+						{ slug: 'guides/configuration/trigger-reusable-actions-with-saved-prompts', label: 'Trigger reusable actions with saved prompts' },
+						{ slug: 'guides/configuration/how-to-set-up-self-serve-data-analytics-with-skills', label: 'Set up self-serve data analytics with Skills' },
+						{ slug: 'guides/configuration/how-to-sync-your-monorepos', label: 'Sync your monorepos' },
 					],
 				},
 				{
 					label: 'External tools & integrations',
 					collapsed: true,
 					items: [
-						{ slug: 'guides/external-tools/how-to-set-up-claude-code', label: 'Set Up Claude Code' },
-						{ slug: 'guides/external-tools/how-to-set-up-codex-cli', label: 'Set Up Codex CLI' },
-						{ slug: 'guides/external-tools/how-to-set-up-opencode', label: 'Set Up OpenCode' },
-						{ slug: 'guides/external-tools/how-to-set-up-gemini-cli', label: 'Set Up Gemini CLI' },
-						{ slug: 'guides/external-tools/how-to-set-up-ollama', label: 'Set Up Ollama for Local Models' },
-						{ slug: 'guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website', label: 'Sentry MCP: Fix Errors' },
-						{ slug: 'guides/external-tools/figma-remote-mcp-create-a-website-from-a-figma-file-from-scratch', label: 'Figma Remote MCP: Create a Website from a Figma File' },
-						{ slug: 'guides/external-tools/linear-mcp-retrieve-issue-data', label: 'Linear MCP: Retrieve Issue Data' },
-						{ slug: 'guides/external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach', label: 'Linear MCP: Updating Tickets' },
-						{ slug: 'guides/external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues', label: 'GitHub MCP: Summarizing PRs & Creating Issues' },
-						{ slug: 'guides/external-tools/puppeteer-mcp-scraping-amazon-web-reviews', label: 'Puppeteer MCP: Scraping Web Reviews' },
-						{ slug: 'guides/external-tools/context7-mcp-update-astro-project-with-best-practices', label: 'Context7 MCP: Update with Best Practices' },
-						{ slug: 'guides/external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up', label: 'SQLite and Stripe MCP: Basic Queries' },
-						{ slug: 'guides/external-tools/using-mcp-servers-with-warp', label: 'Connect Agents to MCP Servers' },
+						{ slug: 'guides/external-tools/how-to-set-up-claude-code', label: 'Set up Claude Code' },
+						{ slug: 'guides/external-tools/how-to-set-up-codex-cli', label: 'Set up Codex CLI' },
+						{ slug: 'guides/external-tools/how-to-set-up-opencode', label: 'Set up OpenCode' },
+						{ slug: 'guides/external-tools/how-to-set-up-gemini-cli', label: 'Set up Gemini CLI' },
+						{ slug: 'guides/external-tools/how-to-set-up-ollama', label: 'Set up Ollama for local models' },
+						{ slug: 'guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website', label: 'Sentry MCP: fix errors' },
+						{ slug: 'guides/external-tools/figma-remote-mcp-create-a-website-from-a-figma-file-from-scratch', label: 'Figma remote MCP: create a website from a Figma file' },
+						{ slug: 'guides/external-tools/linear-mcp-retrieve-issue-data', label: 'Linear MCP: retrieve issue data' },
+						{ slug: 'guides/external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach', label: 'Linear MCP: update tickets' },
+						{ slug: 'guides/external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues', label: 'GitHub MCP: summarize PRs and create issues' },
+						{ slug: 'guides/external-tools/puppeteer-mcp-scraping-amazon-web-reviews', label: 'Puppeteer MCP: scrape web reviews' },
+						{ slug: 'guides/external-tools/context7-mcp-update-astro-project-with-best-practices', label: 'Context7 MCP: update with best practices' },
+						{ slug: 'guides/external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up', label: 'SQLite and Stripe MCP: basic queries' },
+						{ slug: 'guides/external-tools/using-mcp-servers-with-warp', label: 'Connect agents to MCP servers' },
 					],
 				},
 				{
 					label: 'Build an app in Warp',
 					collapsed: true,
 					items: [
-						{ slug: 'guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway', label: 'Build a Real-time Chat App' },
-						{ slug: 'guides/build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css', label: 'Build a Chrome Extension' },
-						{ slug: 'guides/build-an-app-in-warp/building-warps-input-with-warp', label: 'Build Warp\'s Own Input Component' },
+						{ slug: 'guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway', label: 'Build a real-time chat app' },
+						{ slug: 'guides/build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css', label: 'Build a Chrome extension' },
+						{ slug: 'guides/build-an-app-in-warp/building-warps-input-with-warp', label: 'Build Warp\'s input component' },
 						'guides/build-an-app-in-warp/building-a-slackbot',
 					],
 				},
@@ -690,21 +690,21 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
 					label: 'DevOps & infrastructure',
 					collapsed: true,
 					items: [
-						{ slug: 'guides/devops/how-to-analyze-cloud-run-logs-gcloud', label: 'Analyze Cloud Run Logs (gcloud)' },
-						{ slug: 'guides/devops/how-to-create-a-production-ready-docker-setup', label: 'Create a Production-Ready Docker Setup' },
-						{ slug: 'guides/devops/improve-your-kubernetes-workflow-kubectl-helm', label: 'Improve Your Kubernetes Workflow' },
-						{ slug: 'guides/devops/how-to-prevent-secrets-from-leaking', label: 'Prevent Secrets from Leaking' },
-						{ slug: 'guides/devops/how-to-generate-unit-and-security-tests-to-debug-faster', label: 'Generate Unit and Security Tests' },
-						{ slug: 'guides/devops/how-to-write-sql-commands-inside-a-postgres-repl', label: 'Write SQL Commands in a Postgres REPL' },
-						{ slug: 'guides/devops/how-to-create-priority-matrix-for-database-optimization', label: 'Create a Priority Matrix for Database Optimization' },
+						{ slug: 'guides/devops/how-to-analyze-cloud-run-logs-gcloud', label: 'Analyze Cloud Run logs (gcloud)' },
+						{ slug: 'guides/devops/how-to-create-a-production-ready-docker-setup', label: 'Create a production-ready Docker setup' },
+						{ slug: 'guides/devops/improve-your-kubernetes-workflow-kubectl-helm', label: 'Improve your Kubernetes workflow' },
+						{ slug: 'guides/devops/how-to-prevent-secrets-from-leaking', label: 'Prevent secrets from leaking' },
+						{ slug: 'guides/devops/how-to-generate-unit-and-security-tests-to-debug-faster', label: 'Generate unit and security tests' },
+						{ slug: 'guides/devops/how-to-write-sql-commands-inside-a-postgres-repl', label: 'Write SQL commands in a Postgres REPL' },
+						{ slug: 'guides/devops/how-to-create-priority-matrix-for-database-optimization', label: 'Create a priority matrix for database optimization' },
 					],
 				},
 				{
 					label: 'Frontend & UI',
 					collapsed: true,
 					items: [
-						{ slug: 'guides/frontend/how-to-replace-a-ui-element-in-warp-rust-codebase', label: 'Replace a UI Element (Rust Codebase)' },
-						{ slug: 'guides/frontend/how-to-actually-code-ui-that-matches-your-mockup-react-tailwind', label: 'Code UI That Matches Your Mockup (React + Tailwind)' },
+						{ slug: 'guides/frontend/how-to-replace-a-ui-element-in-warp-rust-codebase', label: 'Replace a UI element in Warp (Rust codebase)' },
+						{ slug: 'guides/frontend/how-to-actually-code-ui-that-matches-your-mockup-react-tailwind', label: 'Code UI that matches your mockup (React + Tailwind)' },
 					],
 				},
 			],

From b3454c38e941b5aee6df93d3efcd7e3a8fc0854c Mon Sep 17 00:00:00 2001
From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com>
Date: Thu, 28 May 2026 13:28:31 -0600
Subject: [PATCH 08/10] style: drop 'How to' prefix, normalize gerunds to
 imperative verbs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

All guide titles now use imperative verbs consistently:
- 'How to set up Claude Code' → 'Set up Claude Code'
- 'Building a Slackbot' → 'Build a Slackbot'
- 'Understanding your codebase' → 'Understand your codebase'
- 'Using MCP servers with Warp' → 'Use MCP servers with Warp'

40 titles updated. Titles that don't follow a verb pattern are
unchanged (numbered lists, comparisons, MCP colon format).

Co-Authored-By: Oz <oz-agent@warp.dev>
---
 .../guides/agent-workflows/how-to-edit-agent-code-in-warp.mdx   | 2 +-
 .../how-to-explain-your-codebase-using-warp-rust-codebase.mdx   | 2 +-
 .../guides/agent-workflows/how-to-review-ai-generated-code.mdx  | 2 +-
 .../agent-workflows/how-to-review-prs-like-a-senior-dev.mdx     | 2 +-
 ...3-agents-in-parallel-summarize-logs-analyze-pr-modify-ui.mdx | 2 +-
 .../agent-workflows/how-to-run-multiple-ai-coding-agents.mdx    | 2 +-
 .../how-to-use-voice-and-images-to-prompt-coding-agents.mdx     | 2 +-
 .../running-multiple-agents-at-once-with-warp.mdx               | 2 +-
 .../docs/guides/agent-workflows/understanding-your-codebase.mdx | 2 +-
 .../agent-workflows/using-images-as-context-with-warp.mdx       | 2 +-
 .../building-a-chrome-extension-d3js-javascript-html-css.mdx    | 2 +-
 .../building-a-real-time-chat-app-github-mcp-railway.mdx        | 2 +-
 .../docs/guides/build-an-app-in-warp/building-a-slackbot.mdx    | 2 +-
 .../build-an-app-in-warp/building-warps-input-with-warp.mdx     | 2 +-
 .../docs/guides/configuration/creating-rules-for-agents.mdx     | 2 +-
 .../how-to-configure-yolo-and-strategic-agent-profiles.mdx      | 2 +-
 ...-rules-for-an-existing-project-astro-typescript-tailwind.mdx | 2 +-
 .../guides/configuration/how-to-set-coding-best-practices.mdx   | 2 +-
 .../configuration/how-to-set-coding-preferences-with-rules.mdx  | 2 +-
 .../how-to-set-tech-stack-preferences-with-rules.mdx            | 2 +-
 .../how-to-set-up-self-serve-data-analytics-with-skills.mdx     | 2 +-
 .../docs/guides/configuration/how-to-sync-your-monorepos.mdx    | 2 +-
 .../configuration/how-to-use-agent-profiles-efficiently.mdx     | 2 +-
 .../docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx | 2 +-
 .../devops/how-to-create-a-production-ready-docker-setup.mdx    | 2 +-
 .../how-to-create-priority-matrix-for-database-optimization.mdx | 2 +-
 .../how-to-generate-unit-and-security-tests-to-debug-faster.mdx | 2 +-
 .../docs/guides/devops/how-to-prevent-secrets-from-leaking.mdx  | 2 +-
 .../devops/how-to-write-sql-commands-inside-a-postgres-repl.mdx | 2 +-
 .../docs/guides/external-tools/how-to-set-up-claude-code.mdx    | 2 +-
 .../docs/guides/external-tools/how-to-set-up-codex-cli.mdx      | 2 +-
 .../docs/guides/external-tools/how-to-set-up-gemini-cli.mdx     | 2 +-
 src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx | 2 +-
 .../docs/guides/external-tools/how-to-set-up-opencode.mdx       | 2 +-
 .../docs/guides/external-tools/using-mcp-servers-with-warp.mdx  | 2 +-
 ...actually-code-ui-that-matches-your-mockup-react-tailwind.mdx | 2 +-
 .../how-to-replace-a-ui-element-in-warp-rust-codebase.mdx       | 2 +-
 .../getting-started/how-to-customize-warps-appearance.mdx       | 2 +-
 .../getting-started/how-to-master-warps-code-review-panel.mdx   | 2 +-
 39 files changed, 39 insertions(+), 39 deletions(-)

diff --git a/src/content/docs/guides/agent-workflows/how-to-edit-agent-code-in-warp.mdx b/src/content/docs/guides/agent-workflows/how-to-edit-agent-code-in-warp.mdx
index 1f4ff80c..8e70185e 100644
--- a/src/content/docs/guides/agent-workflows/how-to-edit-agent-code-in-warp.mdx
+++ b/src/content/docs/guides/agent-workflows/how-to-edit-agent-code-in-warp.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to edit agent code in Warp"
+title: "Edit agent code in Warp"
 description: >-
   Review, edit, and refine AI-generated code diffs directly in Warp — accept,
   reject, or modify changes before applying them.
diff --git a/src/content/docs/guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase.mdx b/src/content/docs/guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase.mdx
index 6f6e606c..d6a2e76f 100644
--- a/src/content/docs/guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase.mdx
+++ b/src/content/docs/guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to explain your codebase using Warp (Rust codebase)"
+title: "Explain your codebase using Warp (Rust codebase)"
 description: >-
   Use Warp's coding agents with semantic and symbol search to explore,
   understand, and modify unfamiliar codebases — demonstrated on a large Rust
diff --git a/src/content/docs/guides/agent-workflows/how-to-review-ai-generated-code.mdx b/src/content/docs/guides/agent-workflows/how-to-review-ai-generated-code.mdx
index 073b912d..a9744c90 100644
--- a/src/content/docs/guides/agent-workflows/how-to-review-ai-generated-code.mdx
+++ b/src/content/docs/guides/agent-workflows/how-to-review-ai-generated-code.mdx
@@ -1,5 +1,5 @@
 ---
-title: How to review AI-generated code
+title: Review AI-generated code
 description: >-
   Review AI-generated code in Warp with visual diffs and inline comments —
   works with Claude Code, Codex, or any CLI agent.
diff --git a/src/content/docs/guides/agent-workflows/how-to-review-prs-like-a-senior-dev.mdx b/src/content/docs/guides/agent-workflows/how-to-review-prs-like-a-senior-dev.mdx
index d8599ff5..bec8af7d 100644
--- a/src/content/docs/guides/agent-workflows/how-to-review-prs-like-a-senior-dev.mdx
+++ b/src/content/docs/guides/agent-workflows/how-to-review-prs-like-a-senior-dev.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to review PRs like a senior dev"
+title: "Review PRs like a senior dev"
 description: >-
   Prompt Warp's coding agent to generate structured PR reviews with risk
   assessment, critical issues, and merge confidence scoring.
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 afb89655..c1569bc0 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"
+title: "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/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx b/src/content/docs/guides/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx
index 7d1f282c..e394000e 100644
--- a/src/content/docs/guides/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx
+++ b/src/content/docs/guides/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx
@@ -1,5 +1,5 @@
 ---
-title: How to run multiple AI coding agents
+title: Run multiple AI coding agents
 description: >-
   Run Claude Code, Codex, and other AI coding agents in parallel using
   vertical tabs, tab configs, and notifications to manage multiple sessions at
diff --git a/src/content/docs/guides/agent-workflows/how-to-use-voice-and-images-to-prompt-coding-agents.mdx b/src/content/docs/guides/agent-workflows/how-to-use-voice-and-images-to-prompt-coding-agents.mdx
index 82d8807f..c3a98ae4 100644
--- a/src/content/docs/guides/agent-workflows/how-to-use-voice-and-images-to-prompt-coding-agents.mdx
+++ b/src/content/docs/guides/agent-workflows/how-to-use-voice-and-images-to-prompt-coding-agents.mdx
@@ -1,5 +1,5 @@
 ---
-title: How to use voice and images to prompt coding agents
+title: Use voice and images to prompt coding agents
 description: >-
   Use voice and image context to prompt coding agents faster in Warp — works
   with Claude Code, Codex, and any CLI agent.
diff --git a/src/content/docs/guides/agent-workflows/running-multiple-agents-at-once-with-warp.mdx b/src/content/docs/guides/agent-workflows/running-multiple-agents-at-once-with-warp.mdx
index a9077ae7..23e875e0 100644
--- a/src/content/docs/guides/agent-workflows/running-multiple-agents-at-once-with-warp.mdx
+++ b/src/content/docs/guides/agent-workflows/running-multiple-agents-at-once-with-warp.mdx
@@ -1,5 +1,5 @@
 ---
-title: Running multiple agents at once with Warp
+title: Run multiple agents at once with Warp
 description: >-
   Run multiple agent tasks simultaneously in Warp — revert PRs, edit
   shortcuts, and add tests across repos without losing context.
diff --git a/src/content/docs/guides/agent-workflows/understanding-your-codebase.mdx b/src/content/docs/guides/agent-workflows/understanding-your-codebase.mdx
index 724607e4..94ef3a05 100644
--- a/src/content/docs/guides/agent-workflows/understanding-your-codebase.mdx
+++ b/src/content/docs/guides/agent-workflows/understanding-your-codebase.mdx
@@ -1,5 +1,5 @@
 ---
-title: Understanding your codebase
+title: Understand your codebase
 description: >-
   Use Warp's Codebase Context to search across client and server repos,
   generate architecture summaries, and onboard to unfamiliar features fast.
diff --git a/src/content/docs/guides/agent-workflows/using-images-as-context-with-warp.mdx b/src/content/docs/guides/agent-workflows/using-images-as-context-with-warp.mdx
index 9b5ce0f5..71b29d0d 100644
--- a/src/content/docs/guides/agent-workflows/using-images-as-context-with-warp.mdx
+++ b/src/content/docs/guides/agent-workflows/using-images-as-context-with-warp.mdx
@@ -1,5 +1,5 @@
 ---
-title: Using images as context with Warp
+title: Use images as context with Warp
 description: >-
   Attach screenshots and design mockups as context for Warp's agent to
   generate UI code, debug visual issues, and match Figma designs.
diff --git a/src/content/docs/guides/build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css.mdx b/src/content/docs/guides/build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css.mdx
index b7db7849..27051f63 100644
--- a/src/content/docs/guides/build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css.mdx
+++ b/src/content/docs/guides/build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css.mdx
@@ -1,5 +1,5 @@
 ---
-title: Building a Chrome extension (D3.js + JavaScript + HTML + CSS)
+title: Build a Chrome extension (D3.js + JavaScript + HTML + CSS)
 description: >-
   Build a D3.js Sankey diagram Chrome extension using Warp — scaffold, debug,
   coordinate multiple agents, and publish to the Chrome Web Store.
diff --git a/src/content/docs/guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway.mdx b/src/content/docs/guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway.mdx
index 9fa1937d..9826cb18 100644
--- a/src/content/docs/guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway.mdx
+++ b/src/content/docs/guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway.mdx
@@ -1,5 +1,5 @@
 ---
-title: Building a real-time chat app (GitHub MCP + Railway)
+title: Build a real-time chat app (GitHub MCP + Railway)
 description: >-
   Build and deploy a real-time chat app with Python, FastAPI, and JavaScript —
   from idea to production, all inside Warp.
diff --git a/src/content/docs/guides/build-an-app-in-warp/building-a-slackbot.mdx b/src/content/docs/guides/build-an-app-in-warp/building-a-slackbot.mdx
index 8696d62d..e6b90d3b 100644
--- a/src/content/docs/guides/build-an-app-in-warp/building-a-slackbot.mdx
+++ b/src/content/docs/guides/build-an-app-in-warp/building-a-slackbot.mdx
@@ -1,5 +1,5 @@
 ---
-title: Building a Slackbot
+title: Build a Slackbot
 description: >-
   Set up a self-hosted Warp Slackbot that answers repo questions and opens PRs
   directly from Slack using Docker and GitHub integration.
diff --git a/src/content/docs/guides/build-an-app-in-warp/building-warps-input-with-warp.mdx b/src/content/docs/guides/build-an-app-in-warp/building-warps-input-with-warp.mdx
index 858c9588..bd9a65f4 100644
--- a/src/content/docs/guides/build-an-app-in-warp/building-warps-input-with-warp.mdx
+++ b/src/content/docs/guides/build-an-app-in-warp/building-warps-input-with-warp.mdx
@@ -1,5 +1,5 @@
 ---
-title: Building Warp's input with Warp
+title: Build Warp's input with Warp
 description: >-
   Watch how a Warp designer uses Warp's own agent to locate, modify, and test
   a UI component change in a large Rust codebase.
diff --git a/src/content/docs/guides/configuration/creating-rules-for-agents.mdx b/src/content/docs/guides/configuration/creating-rules-for-agents.mdx
index e597b2be..9137375d 100644
--- a/src/content/docs/guides/configuration/creating-rules-for-agents.mdx
+++ b/src/content/docs/guides/configuration/creating-rules-for-agents.mdx
@@ -1,5 +1,5 @@
 ---
-title: Creating Rules for agents
+title: Create Rules for agents
 description: >-
   Create reusable Rules in Warp to encode team conventions — like Dockerfile
   patterns or dependency management — so agents follow your standards.
diff --git a/src/content/docs/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx b/src/content/docs/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx
index 5a3d1dd3..84973b85 100644
--- a/src/content/docs/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx
+++ b/src/content/docs/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to configure YOLO and strategic Agent Profiles"
+title: "Configure YOLO and strategic Agent Profiles"
 description: >-
   Configure custom agent profiles in Warp to control planning depth, autonomy,
   and execution speed — demonstrated with YOLO and Strategic examples.
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 fab786ac..434d6a84 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"
+title: "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/configuration/how-to-set-coding-best-practices.mdx b/src/content/docs/guides/configuration/how-to-set-coding-best-practices.mdx
index 8f88b5ab..ed2ae5d4 100644
--- a/src/content/docs/guides/configuration/how-to-set-coding-best-practices.mdx
+++ b/src/content/docs/guides/configuration/how-to-set-coding-best-practices.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to set coding best practices"
+title: "Set coding best practices"
 description: >-
   Use Warp Rules to enforce coding style, TypeScript conventions, and
   documentation quality across AI-generated code.
diff --git a/src/content/docs/guides/configuration/how-to-set-coding-preferences-with-rules.mdx b/src/content/docs/guides/configuration/how-to-set-coding-preferences-with-rules.mdx
index fd128ea4..eba0abdb 100644
--- a/src/content/docs/guides/configuration/how-to-set-coding-preferences-with-rules.mdx
+++ b/src/content/docs/guides/configuration/how-to-set-coding-preferences-with-rules.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to set coding preferences with Rules"
+title: "Set coding preferences with Rules"
 description: >-
   Store your package manager, environment tool, and CLI preferences as Warp
   Rules so agents automatically use pnpm, miniconda, or your preferred tools.
diff --git a/src/content/docs/guides/configuration/how-to-set-tech-stack-preferences-with-rules.mdx b/src/content/docs/guides/configuration/how-to-set-tech-stack-preferences-with-rules.mdx
index 5a1a91b6..0620bb1d 100644
--- a/src/content/docs/guides/configuration/how-to-set-tech-stack-preferences-with-rules.mdx
+++ b/src/content/docs/guides/configuration/how-to-set-tech-stack-preferences-with-rules.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to set tech stack preferences with Rules"
+title: "Set tech stack preferences with Rules"
 description: >-
   Define your preferred frameworks and tech stack in Warp Rules so agents
   consistently use Astro, SvelteKit, Vite, or your tools of choice.
diff --git a/src/content/docs/guides/configuration/how-to-set-up-self-serve-data-analytics-with-skills.mdx b/src/content/docs/guides/configuration/how-to-set-up-self-serve-data-analytics-with-skills.mdx
index 8c2e66c7..c1242afb 100644
--- a/src/content/docs/guides/configuration/how-to-set-up-self-serve-data-analytics-with-skills.mdx
+++ b/src/content/docs/guides/configuration/how-to-set-up-self-serve-data-analytics-with-skills.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to set up self-serve data analytics with Skills"
+title: "Set up self-serve data analytics with Skills"
 description: >-
   Set up a self-serve data analytics workflow in Warp using two community
   Skills that map questions to dbt models and structure reproducible analyses.
diff --git a/src/content/docs/guides/configuration/how-to-sync-your-monorepos.mdx b/src/content/docs/guides/configuration/how-to-sync-your-monorepos.mdx
index b27e2206..5b552c3c 100644
--- a/src/content/docs/guides/configuration/how-to-sync-your-monorepos.mdx
+++ b/src/content/docs/guides/configuration/how-to-sync-your-monorepos.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to sync your monorepos"
+title: "Sync your monorepos"
 description: >-
   Define global Rules in Warp to keep monorepo schemas, server types, and
   client types automatically synchronized across repositories.
diff --git a/src/content/docs/guides/configuration/how-to-use-agent-profiles-efficiently.mdx b/src/content/docs/guides/configuration/how-to-use-agent-profiles-efficiently.mdx
index 22e947e3..6a74b4ba 100644
--- a/src/content/docs/guides/configuration/how-to-use-agent-profiles-efficiently.mdx
+++ b/src/content/docs/guides/configuration/how-to-use-agent-profiles-efficiently.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to use Agent Profiles efficiently"
+title: "Use Agent Profiles efficiently"
 description: >-
   Compare Strategic and YOLO agent profiles side-by-side to choose the right
   balance of planning, safety, and speed for your project.
diff --git a/src/content/docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx b/src/content/docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx
index bc1fd289..b98166ab 100644
--- a/src/content/docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx
+++ b/src/content/docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to analyze Cloud Run logs (gcloud)"
+title: "Analyze Cloud Run logs (gcloud)"
 description: >-
   Use Warp to pull, organize, and analyze Cloud Run production logs by
   severity with natural language prompts and automated Python scripts.
diff --git a/src/content/docs/guides/devops/how-to-create-a-production-ready-docker-setup.mdx b/src/content/docs/guides/devops/how-to-create-a-production-ready-docker-setup.mdx
index f3503961..eaa25977 100644
--- a/src/content/docs/guides/devops/how-to-create-a-production-ready-docker-setup.mdx
+++ b/src/content/docs/guides/devops/how-to-create-a-production-ready-docker-setup.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to create a production-ready Docker setup"
+title: "Create a production-ready Docker setup"
 description: >-
   Use Agents in Warp to generate optimized Dockerfiles, docker-compose
   configs, and .dockerignore files for multi-stage production deployments.
diff --git a/src/content/docs/guides/devops/how-to-create-priority-matrix-for-database-optimization.mdx b/src/content/docs/guides/devops/how-to-create-priority-matrix-for-database-optimization.mdx
index 3a173e7d..2d1c5935 100644
--- a/src/content/docs/guides/devops/how-to-create-priority-matrix-for-database-optimization.mdx
+++ b/src/content/docs/guides/devops/how-to-create-priority-matrix-for-database-optimization.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to create a priority matrix for database optimization"
+title: "Create a priority matrix for database optimization"
 description: >-
   Prompt Warp to audit SQL queries, analyze execution plans, and generate a
   priority matrix ranking database optimizations by impact and effort.
diff --git a/src/content/docs/guides/devops/how-to-generate-unit-and-security-tests-to-debug-faster.mdx b/src/content/docs/guides/devops/how-to-generate-unit-and-security-tests-to-debug-faster.mdx
index 96a7fe68..a1589752 100644
--- a/src/content/docs/guides/devops/how-to-generate-unit-and-security-tests-to-debug-faster.mdx
+++ b/src/content/docs/guides/devops/how-to-generate-unit-and-security-tests-to-debug-faster.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to generate unit and security tests to debug faster"
+title: "Generate unit and security tests to debug faster"
 description: >-
   Prompt Warp to generate comprehensive unit and security tests for REST APIs,
   including SQL injection, XSS, and auth validation checks.
diff --git a/src/content/docs/guides/devops/how-to-prevent-secrets-from-leaking.mdx b/src/content/docs/guides/devops/how-to-prevent-secrets-from-leaking.mdx
index fed9e466..9a307ecf 100644
--- a/src/content/docs/guides/devops/how-to-prevent-secrets-from-leaking.mdx
+++ b/src/content/docs/guides/devops/how-to-prevent-secrets-from-leaking.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to prevent secrets from leaking"
+title: "Prevent secrets from leaking"
 description: >-
   Use Warp Rules and built-in secret reduction to prevent API keys and
   credentials from leaking in agent output, demos, and shared sessions.
diff --git a/src/content/docs/guides/devops/how-to-write-sql-commands-inside-a-postgres-repl.mdx b/src/content/docs/guides/devops/how-to-write-sql-commands-inside-a-postgres-repl.mdx
index 5149370b..dccb8975 100644
--- a/src/content/docs/guides/devops/how-to-write-sql-commands-inside-a-postgres-repl.mdx
+++ b/src/content/docs/guides/devops/how-to-write-sql-commands-inside-a-postgres-repl.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to write SQL commands inside a Postgres REPL"
+title: "Write SQL commands inside a Postgres REPL"
 description: >-
   Use Agents in Warp inside a Postgres REPL to translate natural language into
   SQL queries — works with Node.js, Python, and MySQL too.
diff --git a/src/content/docs/guides/external-tools/how-to-set-up-claude-code.mdx b/src/content/docs/guides/external-tools/how-to-set-up-claude-code.mdx
index d047bcb2..443f9106 100644
--- a/src/content/docs/guides/external-tools/how-to-set-up-claude-code.mdx
+++ b/src/content/docs/guides/external-tools/how-to-set-up-claude-code.mdx
@@ -1,5 +1,5 @@
 ---
-title: How to set up Claude Code
+title: Set up Claude Code
 description: >-
   Set up Claude Code in Warp, configure it for your project, and learn
   productivity tips — from voice prompting to visual code review.
diff --git a/src/content/docs/guides/external-tools/how-to-set-up-codex-cli.mdx b/src/content/docs/guides/external-tools/how-to-set-up-codex-cli.mdx
index 536faed6..749ca2c5 100644
--- a/src/content/docs/guides/external-tools/how-to-set-up-codex-cli.mdx
+++ b/src/content/docs/guides/external-tools/how-to-set-up-codex-cli.mdx
@@ -1,5 +1,5 @@
 ---
-title: How to set up Codex CLI
+title: Set up Codex CLI
 description: >-
   Set up OpenAI's Codex CLI in Warp, configure it for your project, and learn
   productivity tips for faster AI-assisted coding workflows in Warp.
diff --git a/src/content/docs/guides/external-tools/how-to-set-up-gemini-cli.mdx b/src/content/docs/guides/external-tools/how-to-set-up-gemini-cli.mdx
index ee26a072..c54f4ef2 100644
--- a/src/content/docs/guides/external-tools/how-to-set-up-gemini-cli.mdx
+++ b/src/content/docs/guides/external-tools/how-to-set-up-gemini-cli.mdx
@@ -1,5 +1,5 @@
 ---
-title: How to set up Gemini CLI
+title: Set up Gemini CLI
 description: >-
   Set up Google's Gemini CLI in Warp, configure it for your project, and learn
   productivity tips for faster AI-assisted coding workflows.
diff --git a/src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx b/src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx
index 35b2a024..05af6f5a 100644
--- a/src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx
+++ b/src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx
@@ -1,5 +1,5 @@
 ---
-title: How to set up Ollama
+title: Set up Ollama
 description: >-
   Install Ollama, run LLMs locally, compare model performance, and integrate
   local models into your apps using Warp.
diff --git a/src/content/docs/guides/external-tools/how-to-set-up-opencode.mdx b/src/content/docs/guides/external-tools/how-to-set-up-opencode.mdx
index 2491ba62..dffba9de 100644
--- a/src/content/docs/guides/external-tools/how-to-set-up-opencode.mdx
+++ b/src/content/docs/guides/external-tools/how-to-set-up-opencode.mdx
@@ -1,5 +1,5 @@
 ---
-title: How to set up OpenCode
+title: Set up OpenCode
 description: >-
   Set up OpenCode in Warp, configure it for your project, and learn
   productivity tips for faster AI-assisted coding workflows.
diff --git a/src/content/docs/guides/external-tools/using-mcp-servers-with-warp.mdx b/src/content/docs/guides/external-tools/using-mcp-servers-with-warp.mdx
index 21a7379b..c3a4724c 100644
--- a/src/content/docs/guides/external-tools/using-mcp-servers-with-warp.mdx
+++ b/src/content/docs/guides/external-tools/using-mcp-servers-with-warp.mdx
@@ -1,5 +1,5 @@
 ---
-title: Using MCP servers with Warp
+title: Use MCP servers with Warp
 description: >-
   Connect MCP servers to Warp's agent, add Rules for automatic tool selection,
   and resolve tickets using external systems like Linear.
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 41b969b9..01e56b4d 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 code UI that matches your mockup"
+title: "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/guides/frontend/how-to-replace-a-ui-element-in-warp-rust-codebase.mdx b/src/content/docs/guides/frontend/how-to-replace-a-ui-element-in-warp-rust-codebase.mdx
index af3bf200..b380e0df 100644
--- a/src/content/docs/guides/frontend/how-to-replace-a-ui-element-in-warp-rust-codebase.mdx
+++ b/src/content/docs/guides/frontend/how-to-replace-a-ui-element-in-warp-rust-codebase.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to replace a UI element in Warp (Rust codebase)"
+title: "Replace a UI element in Warp (Rust codebase)"
 description: >-
   Use Agent Mode in Warp to plan and execute icon replacements across a large
   Rust codebase — with live diffs, auto-compilation, and self-correction.
diff --git a/src/content/docs/guides/getting-started/how-to-customize-warps-appearance.mdx b/src/content/docs/guides/getting-started/how-to-customize-warps-appearance.mdx
index f30c22b5..bf30a766 100644
--- a/src/content/docs/guides/getting-started/how-to-customize-warps-appearance.mdx
+++ b/src/content/docs/guides/getting-started/how-to-customize-warps-appearance.mdx
@@ -1,5 +1,5 @@
 ---
-title: "How to customize Warp's appearance"
+title: "Customize Warp's appearance"
 description: >-
   Customize Warp's themes, input placement, AI settings, codebase indexing,
   team collaboration, and visual appearance to fit your workflow.
diff --git a/src/content/docs/guides/getting-started/how-to-master-warps-code-review-panel.mdx b/src/content/docs/guides/getting-started/how-to-master-warps-code-review-panel.mdx
index 9214ff99..3bcddbd7 100644
--- a/src/content/docs/guides/getting-started/how-to-master-warps-code-review-panel.mdx
+++ b/src/content/docs/guides/getting-started/how-to-master-warps-code-review-panel.mdx
@@ -1,5 +1,5 @@
 ---
-title: How to master Warp's Code Review panel
+title: Master Warp's Code Review panel
 description: >-
   Use Warp's Code Review Panel to view file diffs, edit code inline,
   componentize changes, and commit directly — all without leaving the

From 93300ca6d72eba5ec17004340a5ccf411512bd92 Mon Sep 17 00:00:00 2001
From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com>
Date: Fri, 29 May 2026 08:28:09 -0600
Subject: [PATCH 09/10] a11y: use aria-pressed toggle buttons instead of tab
 semantics

Filter pills are toggle filters on a single card grid, not tabs
with associated tab panels. Switch from role=tab + aria-selected
to role=group + aria-pressed per WAI-ARIA best practices.

Addresses oz-for-oss review suggestion on PR #90.

Co-Authored-By: Oz <oz-agent@warp.dev>
---
 src/components/GuidesLanding.astro | 15 ++++++---------
 1 file changed, 6 insertions(+), 9 deletions(-)

diff --git a/src/components/GuidesLanding.astro b/src/components/GuidesLanding.astro
index 09be5e24..77a20c7f 100644
--- a/src/components/GuidesLanding.astro
+++ b/src/components/GuidesLanding.astro
@@ -138,11 +138,10 @@ const categories = Object.keys(CATEGORY_LABELS).filter((cat) =>
 
 <div class="warp-guide-grid-container not-content">
 	{/* Filter pills — Featured is the default; All shows everything flat */}
-	<div class="warp-guide-filters" role="tablist" aria-label="Filter guides by category">
+	<div class="warp-guide-filters" role="group" aria-label="Filter guides by category">
 		{featured.length > 0 && (
 			<button
-				role="tab"
-				aria-selected="true"
+				aria-pressed="true"
 				class="warp-guide-filter-pill active"
 				data-filter="featured"
 			>
@@ -150,8 +149,7 @@ const categories = Object.keys(CATEGORY_LABELS).filter((cat) =>
 			</button>
 		)}
 		<button
-			role="tab"
-			aria-selected="false"
+			aria-pressed="false"
 			class="warp-guide-filter-pill"
 			data-filter="all"
 		>
@@ -161,8 +159,7 @@ const categories = Object.keys(CATEGORY_LABELS).filter((cat) =>
 			const count = guides.filter((g) => g.category === cat).length;
 			return (
 				<button
-					role="tab"
-					aria-selected="false"
+					aria-pressed="false"
 					class="warp-guide-filter-pill"
 					data-filter={cat}
 				>
@@ -212,10 +209,10 @@ const categories = Object.keys(CATEGORY_LABELS).filter((cat) =>
 				// Update pill states
 				pills.forEach((p) => {
 					p.classList.remove('active');
-					p.setAttribute('aria-selected', 'false');
+					p.setAttribute('aria-pressed', 'false');
 				});
 				pill.classList.add('active');
-				pill.setAttribute('aria-selected', 'true');
+				pill.setAttribute('aria-pressed', 'true');
 
 				// Filter cards
 				cards.forEach((card) => {

From 7ec8db6443daebb11b4d206e4b2a0efbb4da5d00 Mon Sep 17 00:00:00 2001
From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com>
Date: Fri, 29 May 2026 08:59:13 -0600
Subject: [PATCH 10/10] fix: swap Ollama for Run agents unattended in featured
 guides
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Per Petra's feedback — Ollama guide may confuse users asking about
local model support. Replace with the new Run agents unattended
guide which better represents current product capabilities.

Co-Authored-By: Oz <oz-agent@warp.dev>
---
 .../docs/guides/agent-workflows/how-to-run-unattended-agents.mdx | 1 +
 src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx  | 1 -
 2 files changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/guides/agent-workflows/how-to-run-unattended-agents.mdx b/src/content/docs/guides/agent-workflows/how-to-run-unattended-agents.mdx
index da98e7ed..6b9bc188 100644
--- a/src/content/docs/guides/agent-workflows/how-to-run-unattended-agents.mdx
+++ b/src/content/docs/guides/agent-workflows/how-to-run-unattended-agents.mdx
@@ -5,6 +5,7 @@ description: >-
   the Oz CLI, or the Oz API, then inspect every run.
 sidebar:
   label: "Run unattended agents"
+featured: true
 tags:
   - "agents"
   - "cloud-agents"
diff --git a/src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx b/src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx
index 05af6f5a..90680c56 100644
--- a/src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx
+++ b/src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx
@@ -5,7 +5,6 @@ description: >-
   local models into your apps using Warp.
 sidebar:
   label: "Set up Ollama"
-featured: true
 tags:
   - "third-party-tools"