feat(ia-prototype): docs IA restructure for Factories + TUI launches - #379
feat(ia-prototype): docs IA restructure for Factories + TUI launches#379rachaelrenk wants to merge 7 commits into
Conversation
- Rename 'Oz' tab → 'Automation Platform', move to first position - Add Software Factory section as primary group in Automation Platform tab - Restructure platform sidebar: SF first, then Automation Platform, primitives below - Rename 'Oz web app' → 'Warp web app' in sidebar label - Remove software-factory from Orchestration group (now its own top-level section) - Add Warp TUI subsection under Agents > Warp Agents with stub pages Phase 0 (agent-platform → agents slug rename) intentionally deferred. Content rewrites (platform/index.mdx, etc.) deferred to Phase 2. Co-Authored-By: Oz <oz-agent@warp.dev>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
…m tab Co-Authored-By: Oz <oz-agent@warp.dev>
|
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 |
…redirects to /platform/) Co-Authored-By: Oz <oz-agent@warp.dev>
![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 prototypes a docs information-architecture restructure by moving the Automation Platform tab ahead of Terminal, elevating Software Factory, relabeling the web app entry, and adding stub Warp TUI pages under Agents. I did not find security findings, and the attached spec context reports no approved/repository spec to compare against.
Concerns
- The new root redirect sends
/to/platform/while the Terminal sidebar tab still links to/, so clicking Terminal would bounce users back to Automation Platform instead of the Terminal section. It also risks shadowing the existing root markdown rewrite used for agent-readable docs. - The Warp TUI getting-started stub still exposes
/warpas a runnable command even though the page says launch instructions are coming later; this should remain placeholder-only until the command/install path is live.
Verdict
Found: 0 critical, 1 important, 1 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
| ], | ||
| "redirects": [ | ||
| { | ||
| "source": "/", |
There was a problem hiding this comment.
/ to /platform/ makes the still-existing Terminal tab link (link: '/') bounce back to Automation Platform, and it can also shadow the root markdown rewrite; drop this until the root/terminal IA phase moves the homepage/link together.
| ## Run the TUI | ||
|
|
||
| ```bash | ||
| /warp |
There was a problem hiding this comment.
💡 [SUGGESTION] This stub says launch instructions are coming soon, but still publishes /warp as a runnable command; keep this section placeholder-only until the command and install path are live.
…ch-all starlight-sidebar-topics assigns pages to topics by matching the page URL against each topic's link prefix. With link: '/quickstart/', the root index.mdx (URL: /) had no matching topic prefix, crashing the build. Prototype limitation: clicking the Terminal tab pill navigates to / which the Vercel redirect sends to /platform/. Terminal content is still fully reachable via sidebar items. This is inherent to having both a redirect from / and a plugin that uses / as Terminal's catch-all prefix. Co-Authored-By: Oz <oz-agent@warp.dev>
…ink to /terminal/ The starlight-sidebar-topics plugin requires every page in the content collection to be owned by a topic. As long as index.mdx existed at /, the Terminal tab could not use link: '/terminal/' without the plugin erroring on the unowned root page. Fix: delete index.mdx (planned in Phase 2 anyway) → Terminal tab can now correctly use link: '/terminal/', giving the tab pill proper destination. The / → /platform/ Vercel redirect handles any direct URL visits to root. Also creates terminal/index.mdx as a proper Terminal getting-started stub — matching the Phase 2 plan exactly. Note: quickstart, getting-started, code, and knowledge-and-collaboration pages still live under their own URL prefixes (not /terminal/*) so the plugin still uses link: '/terminal/' to activate the Terminal topic for those pages via sidebar item matching, not URL prefix. This works because the plugin checks items membership for non-prefixed pages. Co-Authored-By: Oz <oz-agent@warp.dev>
Co-Authored-By: Oz <oz-agent@warp.dev>
Based on HYC feedback: integrations are often the surfaces that trigger agents, making them logically unified. Integrations items come first, scheduled trigger items follow within the same section. Co-Authored-By: Oz <oz-agent@warp.dev>
1 participant
IA restructure prototype
This is a structural prototype only — nav/sidebar changes with content stubs, no full content rewrites. Intended for sharing alongside the IA plan document for stakeholder feedback via Vercel preview.
What's in this PR
Automation Platform tab (was Oz):
Agents tab:
What's intentionally NOT in this PR
See the full IA plan for the complete phased execution.
Conversation: https://staging.warp.dev/conversation/42fe184c-9601-4da8-b158-200b89b4fd9c
Co-Authored-By: Oz oz-agent@warp.dev