docs: add Warp Factories to docs landing pages - #538
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
I'm starting a first review of this pull request. You can view the conversation on Warp. I completed the review and no human review was requested for this pull request. Comment Powered by Oz |
|
/oz-review |
|
I'm re-reviewing this pull request in response to a review request. You can view the conversation on Warp. I completed the review and no human review was requested for this pull request. Comment Powered by Oz |
![oz-for-oss[bot]](https://avatars.githubusercontent.com/in/3450139?s=60&v=4){kind=small}
There was a problem hiding this comment.
Overview
This PR adds Warp Factories discovery links to the main docs landing page, Agents overview, Enterprise overview, and Guides landing page. The changes are docs-only and introduce no security-sensitive code or applicable spec-drift concerns.
Concerns
- One non-blocking clarity issue: the new Factories sentence on the Agents overview makes the following pronoun ambiguous.
Verdict
Found: 0 critical, 0 important, 1 suggestions
Approve with nits
Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).
Powered by Oz
|
|
||
| For repeatable work that spans multiple agent roles, [Warp Factories](/factories/) coordinates specialized cloud agents across software development workflows, while the {VARS.WARP_AUTOMATION_PLATFORM} provides the underlying cloud-run primitives. | ||
|
|
||
| The {VARS.WARP_AUTOMATION_PLATFORM} tab covers it in full. |
There was a problem hiding this comment.
💡 [SUGGESTION] The new Factories sentence makes it ambiguous; name the platform explicitly so readers do not think this points to Factories.
| The {VARS.WARP_AUTOMATION_PLATFORM} tab covers it in full. | |
| The {VARS.WARP_AUTOMATION_PLATFORM} tab covers the platform in full. |
There was a problem hiding this comment.
Overview
This PR adds concise Warp Factories discovery links to the main docs landing page, Agents overview, Enterprise overview, and Guides landing page. The changes are scoped to documentation copy and internal cross-links.
Concerns
- No blocking concerns found.
- No approved or repository spec context was provided for implementation alignment, and no security-sensitive code or configuration was changed.
Verdict
Found: 0 critical, 0 important, 0 suggestions
Approve
Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).
Powered by Oz
There was a problem hiding this comment.
Overview
This PR adds concise Warp Factories discovery links to the main docs landing page, Agents overview, Enterprise overview, and Guides landing page. The changes are scoped to documentation copy and internal cross-links.
Concerns
- No blocking concerns found.
- No approved or repository spec context was provided for implementation alignment, and no security-sensitive code or configuration was changed.
Verdict
Found: 0 critical, 0 important, 0 suggestions
Approve
Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).
Powered by Oz
|
/oz-review |
|
I'm re-reviewing this pull request in response to a review request. You can view the conversation on Warp. I completed the review and no human review was requested for this pull request. Comment Powered by Oz |
There was a problem hiding this comment.
Overview
This PR adds Warp Factories discovery copy and internal links across the docs root, Agents overview, Enterprise overview, and Guides landing page. The changes are small, docs-only, and generally align with the existing cross-linking and product-positioning patterns.
Concerns
- One root-page subsection may be nested under a parent section that frames the content as ways to use the Warp Agent, while Factories are described as a repeatable multi-agent workflow layer rather than another agent entry point.
Verdict
Found: 0 critical, 0 important, 1 suggestions
Approve
Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).
Powered by Oz
|
|
||
| → [Learn about the {VARS.WARP_AUTOMATION_PLATFORM}](/platform/overview/) | ||
|
|
||
| ### Across software development workflows, with Warp Factories |
There was a problem hiding this comment.
💡 [SUGGESTION] This heading becomes another H3 inside "Three ways to use the Warp Agent," but Factories are described as a repeatable workflow layer rather than a fourth way to use that agent. Consider moving this callout after the section divider or changing the parent structure so the hierarchy does not imply another agent entry point.
f8d76e2 to
5642a1b
Compare
|
/oz-review |
|
I'm re-reviewing this pull request in response to a review request. You can view the conversation on Warp. I completed the review and no human review was requested for this pull request. Comment Powered by Oz |
There was a problem hiding this comment.
Overview
This PR adds concise Warp Factories discovery links to the docs root, Agents overview, Enterprise overview, and Guides landing page. The changes are scoped to landing-page cross-links and align with the existing docs style for short product-discovery copy.
Concerns
- No blocking concerns found.
- No tests or code comments were added or changed.
- No approved or repository spec context was available for implementation-vs-spec validation.
Verdict
Found: 0 critical, 0 important, 0 suggestions
Approve
Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).
Powered by Oz
5642a1b to
1830a5f
Compare
|
/oz-review |
|
This is your last |
|
I'm re-reviewing this pull request in response to a review request. You can view the conversation on Warp. I completed the review and no human review was requested for this pull request. Comment Powered by Oz |
There was a problem hiding this comment.
Overview
This PR adds Warp Factories discovery links to the main docs, Agents, Enterprise, and Guides landing pages. The changes are scoped and docs-only, with no approved spec context to compare against.
Concerns
- The Agents landing page currently renders one new sentence as “the Oz provides,” because
{VARS.WARP_AUTOMATION_PLATFORM}still resolves toOzuntil the platform rename lands.
Verdict
Found: 0 critical, 1 important, 0 suggestions
Request changes
Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).
Powered by Oz
| [**{VARS.WARP_AUTOMATION_PLATFORM}**](/platform/overview/) is Warp's programmable system for running and coordinating agents at scale. It provides the environments, triggers, integrations, orchestration, and observability that cloud agents run on, along with a CLI, API, and SDK for driving agents programmatically. | ||
|
|
||
| The {VARS.WARP_AUTOMATION_PLATFORM} tab covers it in full. | ||
| For repeatable work that spans multiple agent roles, [Warp Factories](/factories/) coordinates specialized cloud agents across software development workflows, while the {VARS.WARP_AUTOMATION_PLATFORM} provides the underlying cloud-run primitives. |
There was a problem hiding this comment.
| For repeatable work that spans multiple agent roles, [Warp Factories](/factories/) coordinates specialized cloud agents across software development workflows, while the {VARS.WARP_AUTOMATION_PLATFORM} provides the underlying cloud-run primitives. | |
| For repeatable work that spans multiple agent roles, [Warp Factories](/factories/) coordinates specialized cloud agents across software development workflows, while {VARS.WARP_AUTOMATION_PLATFORM} provides the underlying cloud-run primitives. |
Co-Authored-By: Warp Agent <agent@warp.dev>
|
/oz-review |
1830a5f to
ceb7583
Compare
|
You've used all 5 |
Rewrite the four Warp Factories blurbs in plain, benefit-led language:
- Replace the repeated 'coordinates specialized cloud agents across
software development workflows' phrasing with concrete descriptions
grounded in the terminology glossary (triage, spec, implement,
review, verify; humans approve key decisions).
- Drop internal implementation jargon ('Oz primitives',
'cloud-run primitives') from user-facing copy.
- Fix the dangling modifier on the Guides landing page.
- Simplify the Enterprise product-list intro and make the Factories
bullet parallel with the other product bullets.
- Match the root landing page's section pattern (divider, bold name,
arrow link) and move 'Early Access' into prose.
Co-Authored-By: Warp <agent@warp.dev>
1 participant
Summary
Adds concise Warp Factories discovery links to four high-value entry points:
The Automation Platform relationship remains owned and reviewed in #516 to avoid overlapping edits to
platform/overview.mdx.Reader journeys
Coordination
Open #503 overlaps the root and Agents pages. Before merging this PR, update it onto the latest
hyc/factory-launchand preserve #503’s final IA/content while retaining only the Factories-specific additions.Foundation
Shared navigation, route placeholders, Early Access badge support, and guide migrations are merged in #537. This PR now contains only its feature-owned files and passes CI independently.
Validation
npm run typecheck: 0 errorsgit diff --check: passed/_llms-txt/support.txtrecursion failure unrelated to these four files; the foundation and all feature PRs build green independently.Proposed reviewers
Based on the Warp Factories Soft Launch (August 18th) tracker. For planning only; no review requests have been sent.
@rachaelrenk@petradonka@johnturcoo