docs(workspaces): match the current sidebar and pin naming

DI
1mo ago
+3-3

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 menuWorkspaces page, Filter → Sidebar
Right-click menu on a sidebar workspace, with Pin as the first itemWorkspaces page Filter menu with PR state, Agent, Created by, and Sidebar; the Sidebar submenu shows All workspaces, Shown, and Hidden

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 lint and bun run typecheck pass (CI fails on lint warnings too). Lint passes on the merge with main at cc31d024c. I did not run the type check: this PR changes one .mdx file, 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.