docs: stage Factories launch phases

[rachaelrenk]

Summary

Promotes Warp Factories to the first product tab, makes the root product overview the Factory-tab destination, and gives Warp Terminal its own overview page.

Changes

• Moves Factories to the first sidebar tab and Automation Platform immediately after it.
• Makes / the Factory-tab destination and adds Warp products as the first entry in Factories Overview.
• Adds /terminal/ as the Terminal overview and restructures Terminal navigation into Overview followed by Get started.
• Preserves the Automation Platform's standalone overview and Cloud agents group.

Content design plan

Audience and JTBD: A developer choosing where to start in the docs who needs the product tabs to match Warp’s GA product hierarchy.

Problem: The Terminal tab currently owns the root product overview, while Warp Factories remains visually secondary despite becoming the primary GA entry point.

Goals: Put Factories first, keep Warp products discoverable at /, and give Terminal a clear product overview plus a separate onboarding path.

Content type: Conceptual navigation and overview update.

High-impact scenarios: Covers a new visitor entering the Factory tab, a Terminal user finding terminal documentation, and a cloud-agent user retaining the Automation Platform path. Excludes Phase 3 web-app migration copy and Phase 4 naming cleanup until their product decisions ship.

Staging and handoff

• Current base - rrenk/grow-6127-factories-ga (Phase 1 / PR docs: restructure factories documentation #748).

• Current PR role - A stacked draft. Phase 2 is implemented; Phase 3 and Phase 4 work can be added as their prerequisites resolve.

• When Phase 1 merges - Keep rrenk/grow-6127-factories-ga until this rebase completes. Rebase the launch branch so only Phase 2–4 commits replay onto origin/main:

  git fetch origin
  git switch rrenk/factories-launch-phases-2-4
  git rebase --onto origin/main rrenk/grow-6127-factories-ga
  git push --force-with-lease origin rrenk/factories-launch-phases-2-4

  Then change this draft PR's base branch to main. If the parent branch has already been deleted, replace rrenk/grow-6127-factories-ga in the command with the final Phase 1 commit SHA from PR docs: restructure factories documentation #748.

• Before Phase 1 merges - Rebase this branch onto the updated Phase 1 branch whenever it receives meaningful changes.

• Workspace - /Users/rachaelrenk/Documents/Warp/docs-factories-launch-phases-2-4.

Validation

• git diff --check - passed.
• python3 .agents/skills/check_for_broken_links/check_links.py --internal-only - passed with 0 broken links across 4,268 internal links.
• npm run build - passed after installing lockfile-pinned dependencies in the isolated worktree.

Unverified claims

None — this change reorganizes existing documentation and navigation without adding product behavior claims.

Documentation risk

Risk: engineering-review-required
Rationale: Changes published navigation order and the root and Terminal documentation entry points.
Source files consulted: GROW-6142, src/sidebar.ts, src/content/docs/index.mdx, src/content/docs/factories/index.mdx, and existing Terminal documentation pages.
Requested engineering reviewers: none
Engineering review status: pending
Docs override: none

Co-Authored-By: Warp agent@warp.dev

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
docs	Ready	Preview	Sep 23, 2026 1:57pm UTC