Skip to content

Spec: SSH/Warpify docs information-architecture reframe - #648

Draft
warp-agent-staging[bot] wants to merge 1 commit into
mainfrom
factory/ssh-warpify-ia-reframe
Draft

Spec: SSH/Warpify docs information-architecture reframe#648
warp-agent-staging[bot] wants to merge 1 commit into
mainfrom
factory/ssh-warpify-ia-reframe

Conversation

@warp-agent-staging

Copy link
Copy Markdown
Contributor

Summary

Spec for the SSH/Warpify docs information-architecture reframe — the carved-out other half of GROW-6086, deliberately left untouched by PR #595. This PR adds only the spec (.agents/specs/ssh-warpify-ia-reframe.md); implementation will follow in this same PR once the spec is approved.

Ticket: pending. Linear was unreachable factory-wide when this spec was written. A Linear ticket will be created and linked here once Linear is back; the spec filename and this PR's metadata block currently use a placeholder task id (PENDING-SSH-WARPIFY-IA) that will be corrected at that point.

Scope

Four files, all under warpdotdev/docs, src/content/docs/terminal/:

  • warpify/ssh.mdx — rewrite the dead tmux-based Warpification section as a short historical note, trim the duplicated "What you get over SSH" feature list to a summary + link to code/ssh-feature-support.mdx, and add one link to the legacy wrapper from the Requirements section's fallback-conditions description.
  • warpify/ssh-legacy.mdx — hide from primary sidebar nav (sidebar: hidden, same pattern as terminal/input/universal-input.mdx) while keeping it directly linkable.
  • warpify/index.mdx — nest "SSH Legacy" under "SSH" instead of listing it as a third co-equal numbered item.
  • terminal/settings/all-settings.mdx — make explicit that enable_legacy_ssh_wrapper and use_ssh_tmux_wrapper have no effect on current behavior (migration-only), not just "deprecated."

All five structural decisions were confirmed with the requester via a structured alignment round (see the spec's Open questions resolved). See the committed spec for full product/tech detail, design alternatives, and validation criteria.

Verification

Spec-only PR — no content changes yet. The committed spec defines the validation/verification criteria implementation must satisfy (npm run build/typecheck, broken-links check, style_lint, validate_ui_refs, plus diff-review checks for scope and link-count invariants).

Originating thread: https://warpdev.slack.com/archives/C09BVK0PL3Y/p1787862877099789

@cla-bot cla-bot Bot added the cla-signed label Aug 27, 2026
@vercel

vercel Bot commented Aug 27, 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 Aug 27, 2026 9:06pm

Request Review

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

Labels

cla-signed warpy-factory Opened by the Warp factory agents

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant