docs(audit): tier 1 — terminology drift + orchestration cross-link#107
Conversation
Cleanup after the orchestration-launch + multi-agent merges: * warp-hosting.mdx - drop 'Oz' prefix from description and body; remove 'easily' per style guide. * enterprise/analytics-api.mdx:139 - '(Oz cloud agents)' -> '(cloud agents)'. * reference/cli/artifacts.mdx:4 - 'produced by an Oz agent run' -> 'by an agent run'. * privacy.mdx telemetry table (4x) - 'ambient agent' -> 'cloud agent' in event descriptions. The literal event names in the left column (AmbientAgent.*, CLI.Execute.Agent.RunAmbient) stay as-is since they're emitted by product code. * warp-for-product-managers.mdx - '5 AI agent workflows…' -> '5 agent workflows…' (drop redundant 'AI' prefix). * cloud-agents/overview.mdx - add Multi-agent orchestration bullet to the Learn more list (was missing after PR #84 landed). Validation: 0 broken links / 2577 internal, lint clears all 11 previously-flagged OZ-TERM warnings, 332 pages build clean. Co-Authored-By: Oz <oz-agent@warp.dev>
|
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-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 updates docs terminology from retired Oz/ambient-agent phrasing to the current cloud agent and agent terminology, and adds the missing multi-agent orchestration cross-link from the cloud agents overview. The changed links and terminology align with the docs glossary and existing orchestration page.
Concerns
- No blocking concerns found. The security pass found no issues in this documentation-only diff.
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
2 participants
Post-orchestration-launch audit, pass 1: clear the OZ-TERM and ambient-agent terminology drift that slipped through #68 + add a missing cross-link to the new #84 orchestration pages.
Changes
Stale 'Oz cloud agent' / 'Oz agent' prefixes
agent-platform/cloud-agents/warp-hosting.mdx:4,9— frontmatter description + body. Also drops the ableist 'easily' per AGENTS.md style guide.enterprise/enterprise-features/analytics-api.mdx:139— 'cloud (Oz cloud agents)' → 'cloud (cloud agents)'.reference/cli/artifacts.mdx:4— 'produced by an Oz agent run' → 'by an agent run'.Retired 'ambient agent' terminology
support-and-community/privacy-and-security/privacy.mdx(4×, telemetry-table descriptions L117, L119, L181, L217) — 'ambient agent' → 'cloud agent'. Event names in the left column (AmbientAgent.*, CLI.Execute.Agent.RunAmbient) are unchanged since they're emitted by product code.Redundant 'AI agent' prefix
guides/agent-workflows/warp-for-product-managers.mdx:2— title '5 AI agent workflows…' → '5 agent workflows…'.Cross-link gap
agent-platform/cloud-agents/overview.mdx— Learn more list was missing a link to Multi-agent orchestration (added after docs(orchestration): add multi-agent orchestration pages #84 landed).Out of scope (handled by in-flight PRs)
self-hosting/unmanaged.mdxis being edited by PR docs(cloud-agents): document customizing workspace snapshots #105 (snapshot-declarations); its 2 remaining OZ-TERM warnings will be fixed there.Validation
Subsequent audit passes (casing sweep, blocklist→denylist) will follow as separate PRs.
Co-Authored-By: Oz oz-agent@warp.dev