Skip to content

docs(environments): add Oz web app creation method, reorder to web app > guided setup > CLI#255

Open
rachaelrenk wants to merge 1 commit into
mainfrom
docs/environments-web-app-creation
Open

docs(environments): add Oz web app creation method, reorder to web app > guided setup > CLI#255
rachaelrenk wants to merge 1 commit into
mainfrom
docs/environments-web-app-creation

Conversation

@rachaelrenk

Copy link
Copy Markdown
Contributor

What

The environments article had a screenshot of the Oz web app Create environment panel but no accompanying instructions — the Oz web app creation flow was undocumented.

Changes

  • Added a "Create an environment from the Oz web app" section with a 4-step procedure
  • Moved the existing screenshot (correctly captioned) under the new section so it's no longer orphaned
  • Added a tip noting the Easy Setup in Warp button, which links to the guided setup flow
  • Reordered creation methods: Oz web app → guided setup in Warp → CLI
  • Updated the intro sentence to describe all three methods upfront
  • Fixed screenshot caption: "Creating a new environment" → "The Create environment panel"

Why

Discovered while reviewing the environments page linked from the software factory guides PR (#236). The existing screenshot was placed before the guided setup section, implying it documented that flow — but it actually shows the Oz web app UI, which has its own distinct creation form with Name, Repos, Docker image, Setup commands, Cloud Providers, Secrets, and Share with team fields.

The Oz web app and the /create-environment guided setup are complementary: the web app provides a manual form, while the guided setup detects your stack and suggests configuration. TheThe Oz web app and the /create-environment guided setup are complementary: the web app provideship The Oz web app and the /create-environment guided setup are complementary: the web apdev>

…p > guided setup > CLI

The environments article had a screenshot of the Oz web app 'Create environment'
panel with no accompanying instructions — the flow was undocumented.

Changes:
- Add 'Create an environment from the Oz web app' section with 4-step procedure
  (name + repos + Docker image → optional fields → Create environment)
- Note the 'Easy Setup in Warp' button that links to the guided setup flow
- Reorder creation methods: Oz web app → guided setup in Warp → CLI
- Move the existing screenshot under the new web app section
- Fix screenshot caption: 'Creating a new environment' → 'The Create environment panel'
- Update intro sentence to describe all three methods upfront

Discovered while reviewing the environments page linked from PR #236
(software factory guides). The existing screenshot was placed before the
guided setup section, implying it documented that flow — but it showed the
Oz web app UI, which has its own distinct creation form.

Co-Authored-By: Oz <oz-agent@warp.dev>
@cla-bot cla-bot Bot added the cla-signed label Jun 25, 2026
@vercel

vercel Bot commented Jun 25, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Jun 25, 2026 6:06pm

Request Review

@oz-for-oss

oz-for-oss Bot commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

@rachaelrenk

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 /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

@oz-for-oss oz-for-oss Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overview

This PR updates the environments documentation to document the Oz web app environment-creation flow, moves the existing screenshot under that flow, and reorders the creation methods before guided setup and CLI creation. The changed instructions are clear, scoped to the documented UI, and consistent with the docs style guidance.

Concerns

  • No blocking concerns found.
  • Security review: no code, configuration, dependency, or data-handling changes were introduced.
  • Spec review: no approved or repository spec context was provided for this PR.

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant