From 0e755d6ed198d56a6a34931c06c40ec84705d6f3 Mon Sep 17 00:00:00 2001 From: hongyi-chen Date: Tue, 18 Aug 2026 00:18:17 +0000 Subject: [PATCH] docs(factories): fix quickstart first-run entry point and stale foreman label Verified the factory setup entry points against warp-server client/packages/factory: - FactoryOnboardingGate redirects any user with no factory to /onboarding, which renders the Welcome screen and its "Let's get started" button. A first-time reader never sees the sidebar, so the "+ next to Factories" instruction only applies once the team already has a factory. - The identity step's alias field is labeled "Foreman name", not "Factory alias", as of warp-server 9e3649c4. Confirms the "+" affordance itself is correct (AppSidebar.tsx renders a Plus link with aria-label "Create factory"); there is no "New factory" button anywhere in the Factory web app. Co-Authored-By: Warp --- src/content/docs/factories/quickstart.mdx | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/src/content/docs/factories/quickstart.mdx b/src/content/docs/factories/quickstart.mdx index 08bcfc7b1..bb1c3d7b9 100644 --- a/src/content/docs/factories/quickstart.mdx +++ b/src/content/docs/factories/quickstart.mdx @@ -20,10 +20,12 @@ A factory is a team of cloud agents — a foreman you talk to, plus the subagent _~5 minutes_ 1. Go to the {VARS.FACTORY_WEB_APP} at platform.warp.dev and sign in. -2. In the sidebar, next to **Factories**, click **+** to start the setup wizard. +2. On the welcome screen, click **Let's get started** to open the setup wizard. + + If your team already has a factory, you land in the app instead of the welcome screen. In the sidebar, click **+** next to **Factories** to open the same wizard. :::note - **No team yet?** If the team that owns the factory has no plan or credits, the wizard will ask you to select one. A factory needs credits to run its agents. + **No team or credits yet?** Warp asks you to join or create a team and choose a plan before the welcome screen. A factory needs credits to run its agents. ::: 3. Click **I want to use repos from GitHub** and complete the GitHub authorization. @@ -31,7 +33,7 @@ _~5 minutes_ Warp provisions a default [environment](/platform/environments/) for the selected repos. -5. Enter a **Factory name**, e.g., `Payments services`. Warp derives a matching **Factory alias**, the handle teammates use to @-mention the factory from connected tools like Slack and Linear. Keep it short and recognizable. +5. Enter a **Factory name**, e.g., `Payments services`. Warp derives a matching **Foreman name**, the handle teammates use to @-mention the factory's foreman from connected tools like Slack and Linear. Keep it short and recognizable. 6. The next screen offers to connect Slack. Click **Next** to skip it for now. See [Connect your factory](/factories/connect-your-factory/) to add integrations later. 7. Toggle the subagents the foreman can dispatch: **Triage**, **Spec**, **Code**, and **Review**. Keep **Code** on so this quickstart's work item can end in a pull request.