Skip to content

docs: Remove legacy Classic and Universal Input docs - #823

Merged
hongyi-chen merged 7 commits into
mainfrom
docs/remove-classic-input
Oct 5, 2026
Merged

hongyi-chen merged 7 commits into
mainfrom
docs/remove-classic-input

Conversation

@warp-agent-staging

@warp-agent-staging warp-agent-staging Bot commented Oct 5, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Remove the retired Classic Input and Universal Input experiences from current documentation while preserving supported Shell prompt (PS1), input-position, Terminal mode, Agent Mode, and auto-detection guidance.

Changes

  • Delete the Classic Input and Universal Input pages and remove both from Terminal navigation.
  • Remove current-page comparisons, instructions, terminology, and screenshots tied to the retired interfaces.
  • Update capability pages and tutorials from the old three-mode model to terminal mode, Agent Mode, and auto-detection behavior.
  • Delete 31 orphaned Classic- and Universal-specific assets.
  • Redirect Classic Input routes to the Shell prompt (PS1) page and Universal Input routes to Terminal and Agent modes; route both /terminal and /terminal/ to Terminal and Agent modes.
  • Preserve historical changelog references, the supported Input type > Shell (PS1) setting, and the separate Start at the top (Classic mode) input-position label.
  • Remove retired modality names from the terminology reference and style-lint proper-feature allowlist.

Validation

  • npm run build — passed; Pagefind indexed 390 HTML files.
  • python3 .agents/skills/check_for_broken_links/check_links.py --internal-only — passed; 389 files and 4,211 internal links checked, 0 broken.
  • python3 .agents/skills/validate_ui_refs/validate_ui_refs.py --changed — passed; 11 files scanned with 0 Settings-path, Command Palette, or formatting issues.
  • python3 .agents/skills/style_lint/style_lint.py --changed — completed with 66 existing warnings across 11 retained pages; comparison with origin/main found 0 new warning identities and 51 removed identities.
  • Compression contract — eight edited pages pass outright. Three existing overages decreased without adding callouts: 1,991→1,806 words, 2,874→2,835 words, and 943→891 words.
  • Focused redirect and stale-reference assertions — passed; 1,299 unique redirect sources, six input-route mappings and destinations verified, both /terminal spellings return 308 to Terminal and Agent modes in the deployed preview, no retired modality terminology in current MDX, historical changelog references preserved, and no legacy page or asset emitted by the build.
  • VERIFY accounting — passed; 0 markers across 13 changed content paths.
  • git diff --check origin/main — passed.
  • python3 scripts/check_redirects.py — reports 211 repository-wide destination failures that predate and do not involve these six pattern routes; focused assertions verify every changed route and destination.
  • trunk check — unavailable because Trunk is not installed in this environment.

Unverified claims

None — current public labels and behavior were verified against Warp client source. Internal InputBoxType::Classic and InputBoxType::Universal names are compatibility implementation details, not supported public modality names.

Documentation risk

Risk: engineering-review-required
Rationale: Removes two public modality pages and reroutes their legacy URLs based on current Warp client behavior.
Source files consulted: app/src/settings_view/appearance_page.rs and app/src/terminal/input/{classic,universal,terminal}.rs @ 023685490da35f4cfe01084b8a5b5792cf70cb2a
Requested engineering reviewers: none — ownership resolution returned only a team, not a single human owner
Engineering review status: pending
Docs override: none

Additional context

Co-Authored-By: Oz oz-agent@warp.dev

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

vercel Bot commented Oct 5, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
docs Ready Ready Preview Oct 5, 2026 10:00pm UTC

Request Review

@warp-agent-staging warp-agent-staging Bot added warpy-factory Opened by the Warp factory agents factory:docs-factory Label associated to the "docs-factory" factory labels Oct 5, 2026
@warp-agent-staging

Copy link
Copy Markdown
Contributor Author

This PR was generated with Warp.

Comment @warp-staging-factory on this PR to send it follow-up work.

View run View conversation View on Slack

Co-Authored-By: Oz <oz-agent@warp.dev>
@warp-agent-staging
warp-agent-staging Bot marked this pull request as ready for review October 5, 2026 12:26
@warp-for-oss

warp-for-oss Bot commented Oct 5, 2026 •

Copy link
Copy Markdown
Contributor

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

Powered by Oz

@warp-for-oss warp-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 removes unsupported Classic Input documentation, removes current references and assets tied to that surface, and redirects legacy routes to the current Terminal and Agent modes page.

Concerns

  • One non-blocking docs style suggestion: format the non-interactive field label as quoted text rather than bold UI control text.

Security

No security concerns found.

Verdict

Found: 0 critical, 0 important, 1 suggestions

Approve

Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

Comment thread src/content/docs/terminal/appearance/prompt.mdx Outdated
@warp-agent-staging
warp-agent-staging Bot marked this pull request as draft October 5, 2026 20:21
warp-agent-staging Bot and others added 3 commits October 5, 2026 20:36
Co-Authored-By: Oz <oz-agent@warp.dev>
Co-Authored-By: Oz <oz-agent@warp.dev>
Co-Authored-By: Oz <oz-agent@warp.dev>
@warp-agent-staging warp-agent-staging Bot changed the title docs: Remove unsupported Classic Input documentation docs: Remove legacy Classic and Universal Input docs Oct 5, 2026
@warp-agent-staging
warp-agent-staging Bot marked this pull request as ready for review October 5, 2026 20:42
@warp-for-oss

warp-for-oss Bot commented Oct 5, 2026 •

Copy link
Copy Markdown
Contributor

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

Powered by Oz

@warp-for-oss warp-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 removes the retired Classic Input and Universal Input documentation pages/assets, updates retained docs and terminology to the current terminal mode, Agent Mode, and auto-detection language, and redirects legacy routes to supported destinations.

Concerns

No correctness, security, spec-alignment, link/redirect, comment-quality, or test-quality concerns were found in the annotated diff. No approved or repository spec context was available for this implementation PR.

Verdict

Found: 0 critical, 0 important, 0 suggestions

Approve

Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

@github-actions github-actions 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.

Review summary

The independent agent completed its review for this commit.

Findings

  • src/content/docs/getting-started/quickstart/customizing-warp.mdx:56 — [SUGGESTION] The PR removes the 'Input format' table row and the 'Standard vs Classic input' bullet, but the Input type setting (Warp or Shell (PS1)) still exists in the product and is documented on the Prompt page, so a supported customization is no longer discoverable here. Requested change: replace the removed row and bullet with a single entry that links to /terminal/appearance/prompt/.
  • src/content/docs/guides/getting-started/how-to-make-warps-ui-more-minimal.mdx:61 — [SUGGESTION] The 'Switch to the Classic Prompt' step was deleted entirely, but a text-first minimal look is still available through Input type > Shell (PS1) and the prompt chip customizer. Requested change: replace it with a short Shell (PS1) step linking to /terminal/appearance/prompt/, or state in the PR body why the tip was dropped.
  • src/content/docs/agents/local-agents/agent-context/images-as-context.mdx:16 — [NIT] 'Select the image upload button in the agent input.' uses 'Select' for a button (style guide: Click) and breaks parallelism with the other bullets. Requested change: use 'Click the image upload button in the agent input toolbelt.'

Verdict

Approve with nits

@github-actions github-actions 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.

Review summary

The independent agent completed its review for this commit.

Findings

  • src/content/docs/agents/local-agents/interacting-with-agents/terminal-and-agent-modes.mdx:303 — [SUGGESTION] The deleted classic-input.mdx and universal-input.mdx pages were the only place documenting the false-detection fix (Natural language denylist), the Show input hint text setting, and the * prefix that forces Agent Mode. Requested change: confirm those settings still exist in the client, and if they do, add a short mention to the auto-detection section of this page.
  • src/content/docs/agents/local-agents/interacting-with-agents/terminal-and-agent-modes.mdx:84 — [SUGGESTION] The compression contract check (feature-doc) still reports this page at 2,835 words and 7 callouts (budget 1,500 words and 2 callouts), and interacting-with-agents/index.mdx at 1,806 words and 6 callouts. The PR body says both overages decreased but gives no justification for the remainder. Requested change: add a one-line justification to the PR body or defer the cut to a follow-up.
  • src/content/docs/agents/local-agents/agent-context/images-as-context.mdx:16 — [NIT] The text "Select the image upload button in the agent input." uses the wrong verb for a button. Requested change: use "Click the image upload button in the agent input."

Verdict

Approve with nits

@hongyi-chen
hongyi-chen merged commit bef5e5b into main Oct 5, 2026
9 of 11 checks passed
@hongyi-chen
hongyi-chen deleted the docs/remove-classic-input branch October 5, 2026 21:57

This branch was successfully deployed

1 active deployment
Preview — b00ab93a Deployed Oct 5, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed factory:docs-factory Label associated to the "docs-factory" factory warpy-factory Opened by the Warp factory agents

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants