docs(workspaces): match the current sidebar and pin naming
What & why
Refs #6994.
#6994 says "Pin" meant two different things. #7000 fixed the app side: the Workspaces page now says "Show on Sidebar" / "Hide from Sidebar", and the sidebar keeps "Pin" / "Unpin" for the Pinned section. apps/docs/content/docs/workspaces.mdx still used the old wording, so this PR updates it:
- The sidebar context menu action is Pin (or Unpin), not Pin to Sidebar.
- The Workspaces filter is Sidebar (All workspaces / Shown / Hidden), not Pinned (All workspaces / Pinned / Unpinned).
- The Filter menu holds PR state, Agent, Created by, and Sidebar. The docs also listed Project and Device there, but since #6901 the device is picked from the page title and projects from their own menu next to Filter. The docs now say that.
With this, #6994 can be closed.
Not included: the marketing site still says "Pin to Sidebar".
Screenshots
The labels the docs now use, in the dev app:
| Sidebar context menu | Workspaces page, Filter → Sidebar |
|---|---|
![]() | ![]() |
The sidebar shot was taken on the #8434 branch, so the worktree row shows that PR's fork icon.
How I tested it
Docs only. I checked the wording against the labels on main: V2WorkspaceContextMenu, V2WorkspacesHeader (Filter menu, device title menu, project menu), v2WorkspacesFilterStore, the v2-workspaces route search params (device, projects, and the Filter values all sync to the URL), and the sidebar workspace context menu. None of these files changed on main between a8c6da1c2 and cc31d024c.
Checklist
- PR title follows conventional commits (
type(scope): subject) -
bun run lintandbun run typecheckpass (CI fails on lint warnings too). Lint passes on the merge withmainat cc31d024c. I did not run the type check: this PR changes one.mdxfile, which it does not check. - "Allow edits from maintainers" is checked on fork PRs
Summary by cubic
Aligns the workspaces docs with the current sidebar and Workspaces-page naming, so "Pin" now refers only to the pinned section at the top of the sidebar. The Filter menu is now listed as PR state, Agent, Created by, and Sidebar, with Device and Project moved to the page title and the menu next to Filter. Closes #6994.
Summary by CodeRabbit
- Documentation
- Updated workspace pinning instructions to use the sidebar’s Pin and Unpin options.
- Clarified how to select a device and project, and documented the Sidebar filter options: All workspaces, Shown, and Hidden.

