docs: terminology sweep — CLI/API sunset callouts + fold PR #583 overlap (GROW-6090) - #680
Conversation
Folds the overlapping portions of open PR #583 (factory/rev-38-docs-audit-findings) into GROW-6090's fresh branch: - terminology.md glossary additions (Launch Configuration, Computer Use, Full Terminal Use, Direct backend, ZDR, SSO, BYOLLM, Bitbucket Data Center, Workload Identity terms) - style_lint context-aware terminology scanner, header sentence-boundary, product-casing, and third-party proper-name checks + regression tests - terminology/casing nits across MDX pages (Agent Mode, Codebase Context, Command Palette, cloud agent, sentence-case headers, denylist wording) --mcp well-known-id documentation from #583 already shipped on main via #599 and is not part of this fold.
Adds the missing oz sunset window to the CLI reference caution (and its restated variants across sibling CLI reference pages) and the API/SDK landing page: oz commands remain supported through end of September 2026, and warp successor commands for those workflows are not yet documented. Also corrects the Warp Agent CLI glossary usage note and the vars.ts WARP_CLI comment off the stale 'approximately August 18, 2026' Oz CLI retirement framing, replacing it with the 9/15 oz/Oz web app holdout date plus the end-of-September oz command support fact. API_SDK_NAME is unchanged and no Oz->Warp API backwards-compat callout is added; the successor name for the Oz API is still unconfirmed (tracked as a separate follow-up).
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
@warp-agent-staging[bot] 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 |
![warp-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 terminology references, CLI/API sunset callouts, docs casing, and style-lint regression coverage for terminology fixes. I found two blocking issues in the style-lint changes/tests: one regression fixture blesses lowercasing the Warp product name, and the new detection-only context filtering still leaves --fix able to mutate skipped literals.
Concerns
- The header-case regression fixture expects
Warpto be lowercased in fixed output, which conflicts with docs product-name casing. - The new context-aware product/deprecated-term checks suppress detections in code fences and link destinations, but auto-fix remains global string replacement and can still change those skipped contexts when they appear before a detected prose occurrence.
- Security pass: no security findings.
- Spec drift: no approved or repository spec context was provided.
Verdict
Found: 0 critical, 2 important, 0 suggestions
Request changes
Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).
Powered by Oz
Co-Authored-By: Warp <agent@warp.dev>
![warp-agent-staging[bot]](https://avatars.githubusercontent.com/in/2196476?s=60&v=4){kind=small}
There was a problem hiding this comment.
Overview
This PR adds the CLI and API sunset notices, glossary updates, and terminology-lint protections required by GROW-6090. The header-case auto-fix still rewrites the Warp product name to lowercase.
Verdict
Checks: build ✅ · style-lint regression suites ✅ · CI ✅ · visual proof n/a (docs-only)
Found: 0 critical, 1 important, 0 suggestions
Request changes
Review run
https://oz.staging.warp.dev/runs/01a06877-56cb-7f0a-88a2-ea89de7c99c0
Preserve the capital in "Warp" when _to_sentence_case rewrites a Title Case header, and fix the test fixture that expected "warp".
… follow-up) (#681) * docs: correct Oz CLI/API/web app holdout date from 9/15 to 10/6/2026 (GROW-6090) The Oz CLI/API/web app retirement date changed to October 6, 2026 (the Factories GA launch date) instead of September 15, 2026. Update every 9/15-style reference across the files touched by #680, without touching the separate end-of-September-2026 oz command support-window callouts (a distinct deadline). Co-Authored-By: Warp <agent@warp.dev> * docs: fix remaining Sept 15 holdout dates in platform pages + AGENTS.md (GROW-6090) The prior commit (223b741) updated the holdout date in .agents/references/terminology.md, style_lint.py, vars.ts, and sidebar.ts, but missed the transition-notice comment + note text in platform/index.mdx and platform/overview.mdx, and the two duplicated copies of the terminology entries in the repo-root AGENTS.md style guide. Update all remaining September 15, 2026 / 2026-09-15 references to October 6, 2026, matching each occurrence's existing prose/date format. The unrelated end-of-September-2026 oz command support-window callouts are untouched. Co-Authored-By: Warp <agent@warp.dev> --------- Co-authored-by: warp-agent-staging[bot] <240773466+warp-agent-staging[bot]@users.noreply.github.com> Co-authored-by: Warp <agent@warp.dev>
1 participant
Summary
Closes the loop on the launch-docs terminology sweep for GROW-6090:
ozcommands remain supported through the end of September 2026, and thatwarpequivalents for those workflows aren't documented yet. The API & SDK landing page carries the same note foroz-based examples.vars.tsWARP_CLIcomment off the stale "approximately August 18, 2026" Oz CLI retirement framing, replacing it with the actual 9/15oz/Oz web app holdout date plus the end-of-Septemberozcommand support fact.factory/rev-38-docs-audit-findings, still open):.agents/references/terminology.mdglossary additions (Launch Configuration, Computer Use, Full Terminal Use, Direct backend, ZDR, SSO, BYOLLM, Bitbucket Data Center, Workload Identity terms), the.agents/skills/style_lint/context-aware terminology scanner + header sentence-boundary / product-casing / third-party proper-name checks + their regression tests + theSKILL.mdtest list, and terminology/casing nits across the MDX pages docs: address daily-audit findings (terminology, surface-map hygiene, --mcp well-known-id doc) #583 touched (Agent Mode, Codebase Context, Command Palette, cloud agent, denylist wording, sentence-case headers). The--mcp <well-known-id>doc content from docs: address daily-audit findings (terminology, surface-map hygiene, --mcp well-known-id doc) #583 already shipped onmainvia docs(mcp): document well-known managed integration ids #599, so it's intentionally not part of this fold.This supersedes closed PR #593 (
grow-6090-terminology-sweep, closed unmerged) — this is a fresh branch offmain, not a reuse of that branch. Once this lands, PR #583 will be closed since nothing unique remains in it.Explicitly out of scope (per the ticket):
API_SDK_NAMEinsrc/data/vars.tsis unchanged, and no Oz API → Warp API/SDK backwards-compatibility callout is added — the successor name for "Oz API" is still unconfirmed and is tracked as a separate follow-up.Rework changes
test_header_case_sentence_boundary.py:42blessed lowercasing theWarpproduct name. The_to_sentence_case()fixer had no way to protect a single-word proper noun likeWarp(only exact multi-wordPROPER_FEATURE_NAMESsequences such as "Warp Drive" were protected), so--fixrewrote a bareWarpin a Title Case header towarp. Added aSTANDALONE_PROPER_NOUNSset and a protection branch in_to_sentence_case()soWarpkeeps its capital regardless of position, and updated the regression fixture's expected output from"Is warp fully free? ..."to"Is Warp fully free? ..."to match.Verification
npm run buildsucceeds.python3 .agents/skills/style_lint/style_lint.py --changed— 0 errors (42 pre-existing warnings across touched files, none introduced by this change).test_context_aware_terminology.py,test_header_case_sentence_boundary.py,test_product_casing_word_boundary.py,test_proper_feature_names_third_party.py,test_factory_proper_noun.py,test_platform_determiner.py,test_hardcoded_var_exemptions.py,test_tone_checks.py.Originating thread: https://warpdev.slack.com/archives/C09BVK0PL3Y/p1788456511471569