Thanks to visit codestin.com
Credit goes to github.com

Skip to content

docs: refresh workspace-management screenshots with current UI - #28356

Merged
jakehwll merged 6 commits into
mainfrom
jakehwll/docs-55-update-workspace-management-screenshots
Aug 20, 2026
Merged

docs: refresh workspace-management screenshots with current UI#28356
jakehwll merged 6 commits into
mainfrom
jakehwll/docs-55-update-workspace-management-screenshots

Conversation

@jakehwll

Copy link
Copy Markdown
Contributor

🤖 This PR was written by Coder Agents on behalf of Jake Howell.

Refreshes the six stale screenshots on the Workspaces page (docs/user-guides/workspace-management.md) with the current Coder UI, recreating equivalent dummy data (matching template and workspace names) so the images stay recognizable.

Linear: DOCS-55

Updated images

Image Section
creating-workspace-ui.png Creating workspaces
workspace-update.png Updating workspaces
workspace-automatic-updates.png Automatic updates
user-guides/workspace-bulk-actions.png Bulk operations
schedule.png Starting and stopping
templates/template-variables.png Repairing workspaces

Prose is unchanged; this is a screenshot-only refresh.

Notes / limitations

The originals came from production-like deployments with AWS/Azure/Kubernetes templates, multiple users, and aged data. These were reproduced on a local scripts/develop.sh (Docker) instance, so:

  • Template/workspace names, states (Running/Stopped/Failed), the "Selected 3 of 5" bulk selection, use_kubeconfig=True/namespace=default, and the auto-update = Always setting all match.
  • Instance-derived values cannot match: "used by" counts show 0 developers, build times show Unknown, the connection-latency pill has no value, and the workspace name field is disabled by the template.
How these were produced (decision log)

Followed the dogfood skill:

  1. Started a local instance with ./scripts/develop.sh (v2.36.0-devel, matching the docs version).
  2. Created Docker-backed templates named to match the originals: data-warehouse, analytics, api-services, frontend-web, pod-share-jupyter, aws-linux-ephemeral, azure-aks-pod, plus kubernetes2 ("Develop in Kubernetes"). The JetBrains module was dropped from the Docker template to avoid a plan-time error; kubernetes2 uses a Coder-only variant declaring the real namespace and use_kubeconfig variables so it imports with use_kubeconfig=true.
  3. Created workspaces: admin/my-frontend (outdated → update available, with a schedule), admin/dev (auto-update = Always), and kirby/{data-science, aws-large, azure-space, ephem-demo (Failed), kirbs (Stopped)}.
  4. Captured each page with a headless Playwright script, hiding dev-only chrome (the sticky deployment banner, the navbar ::before hazard stripe, and the -devel version chip) and cropping settings pages to the form. Images are 2x for crispness.
  5. Each screenshot was visually verified against the original for content parity.

@linear-code

linear-code Bot commented Aug 20, 2026

Copy link
Copy Markdown

DOCS-55

@jakehwll jakehwll changed the title 🤖 docs(docs/images): refresh workspace-management screenshots with current UI docs: refresh workspace-management screenshots with current UI Aug 20, 2026
@jakehwll
jakehwll requested a review from matifali August 20, 2026 07:40
@jakehwll
jakehwll marked this pull request as ready for review August 20, 2026 07:40

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review


P2 Badge Update the bulk action label in the instructions

In the refreshed UI shown here, the dropdown is labeled Bulk actions, but docs/user-guides/workspace-management.md:111 still directs readers to the top-right Actions dropdown. This creates an internal mismatch for anyone following the documented UI steps, so update the prose to use the current label alongside this screenshot.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@jakehwll

Copy link
Copy Markdown
Contributor Author

In the refreshed UI shown here, the dropdown is labeled Bulk actions, but docs/user-guides/workspace-management.md:111 still directs readers to the top-right Actions dropdown. This creates an internal mismatch for anyone following the documented UI steps, so update the prose to use the current label alongside this screenshot.

Fair enough... @matifali I am not one for writing good human understanding words can you validate this please 🙂

@matifali
matifali requested a review from nickvigilante August 20, 2026 14:58
Comment thread docs/images/templates/template-variables.png
Comment thread docs/images/user-guides/workspace-bulk-actions.png
Comment thread docs/images/workspace-automatic-updates.png
@coderagents

coderagents Bot commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

Documentation Check

Updates Needed

  • docs/user-guides/workspace-management.md (line 111) - The refreshed workspace-bulk-actions.png screenshot shows the dropdown labeled Bulk actions, but the prose still directs readers to the top-right Actions dropdown. The current UI uses "Bulk actions" (see site/src/pages/WorkspacesPage/WorkspacesPageView.tsx:143). Update the prose label to match the screenshot and current UI so the documented steps stay accurate.

Automated review via Coder Agents

@jakehwll
jakehwll requested a review from matifali August 20, 2026 15:49

@matifali matifali left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Thanks

@matifali

Copy link
Copy Markdown
Member

In the refreshed UI shown here, the dropdown is labeled Bulk actions, but docs/user-guides/workspace-management.md:111 still directs readers to the top-right Actions dropdown. This creates an internal mismatch for anyone following the documented UI steps, so update the prose to use the current label alongside this screenshot.

Fair enough... @matifali I am not one for writing good human understanding words can you validate this please 🙂

I would leave this to @nickvigilante

@nickvigilante nickvigilante 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.

Screenshots LGTM. I think I want to establish some mechanism, either with Pixel or something else, to collect screenshots automatically and standardize the sizing and whatnot. I'll have to ponder this and get back to you, but these are ready to merge now :shipit: 🚀

@jakehwll
jakehwll merged commit d3b3aea into main Aug 20, 2026
25 checks passed
@jakehwll
jakehwll deleted the jakehwll/docs-55-update-workspace-management-screenshots branch August 20, 2026 16:26
@github-actions github-actions Bot locked and limited conversation to collaborators Aug 20, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants