Skip to content

docs: document Pinned tabs#339

Closed
hongyi-chen wants to merge 2 commits into
mainfrom
docs/pinned-tabs
Closed

docs: document Pinned tabs#339
hongyi-chen wants to merge 2 commits into
mainfrom
docs/pinned-tabs

Conversation

@hongyi-chen

Copy link
Copy Markdown
Collaborator

Summary

Documents the Pinned tabs feature, which went GA (the PinnedTabs feature flag is now enabled by default). Users can pin individual tabs and whole tab groups so they stay at the front of the tab bar and are protected from reordering.

What changed

  • Added a Pinned tabs section to terminal/windows/tabs.mdx covering:
    • Pin/unpin an individual tab (Pin tab / Unpin tab from the tab right-click menu).
    • Pin/unpin a whole tab group (Pin group / Unpin group from the group header menu).
    • The keyless keyboard shortcuts (assignable in Settings > Keyboard shortcuts).

Source of truth: app/src/workspace/view/tab_grouping.rs, app/src/tab.rs, and the PinnedTabs flag in crates/warp_features/src/lib.rs (public warpdotdev/warp repo).

Audit context

Generated by the missing_docs drift-watch audit. This finding came from the PinnedTabs flag moving preview -> ga. The companion surface-map + snapshot updates ship in the audit-bookkeeping PR.

Conversation: https://staging.warp.dev/conversation/ce1c5f13-b8a2-497f-843e-57f84d63b745
Run: https://oz.staging.warp.dev/runs/019f7105-5e3a-7d03-8d21-1a7784c46f9a

This PR was generated with Oz.

Pinned tabs (the PinnedTabs feature flag) went GA. Document how to pin and
unpin individual tabs and whole tab groups from the tab right-click menu, and
note the keyless keyboard shortcuts.

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

vercel Bot commented Jul 17, 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, Comment Jul 17, 2026 5:27pm

Request Review

@oz-for-oss

oz-for-oss Bot commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

@hongyi-chen

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

Powered by Oz

@oz-for-oss oz-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 adds a Pinned tabs section to the existing Tabs documentation, covering individual tab pinning, tab group pinning, and keyless shortcut actions. I verified the documented behavior and keybinding labels against the local Warp source referenced by the PR.

Concerns

  • One non-blocking docs-style issue: the new Settings path should orient readers to the Warp app before the menu path.
  • No approved spec context was provided, so there was no implementation-vs-spec drift to assess from the attached context.

Verdict

Found: 0 critical, 0 important, 1 suggestions

Approve with nits

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

Powered by Oz


### Keyboard shortcuts

Pinning actions ship without default keyboard shortcuts. Assign your own in **Settings** > **Keyboard shortcuts** for **Pin current tab**, **Unpin current tab**, **Pin current tab group**, and **Unpin current tab group**.

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.

💡 [SUGGESTION] Orient readers before the Settings path so the instruction follows the docs style guide for first references to app surfaces.

Suggested change
Pinning actions ship without default keyboard shortcuts. Assign your own in **Settings** > **Keyboard shortcuts** for **Pin current tab**, **Unpin current tab**, **Pin current tab group**, and **Unpin current tab group**.
Pinning actions ship without default keyboard shortcuts. In the Warp app, go to **Settings** > **Keyboard shortcuts** to assign shortcuts for **Pin current tab**, **Unpin current tab**, **Pin current tab group**, and **Unpin current tab group**.

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant