Skip to content

docs: add Change Editor on a workspace procedure - #3192

Open
olexii4 wants to merge 1 commit into
mainfrom
CRW-10647
Open

olexii4 wants to merge 1 commit into
mainfrom
CRW-10647

Conversation

@olexii4

@olexii4 olexii4 commented Sep 9, 2026 •

Copy link
Copy Markdown
Contributor

What does this PR do?

Adds a procedure page documenting how to change the IDE on a stopped workspace from the Overview tab, and adds it to the end-user-guide navigation under "IDEs in workspaces".

The page follows the same structure as the existing "Change the AI tool on a workspace" procedure: prerequisites, step-by-step instructions including the version picker, and links to related editor documentation. The procedure clarifies that editors are selected by identifier from the available editors list, not by custom container image.

Screenshot/screencast of this PR

N/A

What issues does this PR fix or reference?

fixes https://redhat.atlassian.net/browse/CRW-10647

Dashboard PR: eclipse-che/che-dashboard#1663

Is it tested? How?

  • Verified the new page renders correctly in the Antora nav tree under User Guide → IDEs in workspaces → Changing the editor on a workspace.
  • Verified all xref links resolve: ides-in-workspaces.adoc, defining-a-common-ide.adoc.
  • No existing pages modified beyond the nav entry.

Release Notes

Added documentation for changing the IDE on a stopped workspace from the dashboard Overview tab.

Docs PR

N/A (this is the docs PR)

@github-actions

github-actions Bot commented Sep 9, 2026 •

Copy link
Copy Markdown

🎊 Navigate the preview: https://6ab10651b83e9ea8ad9c7bc8--eclipse-che-docs-pr.netlify.app 🎊

@github-actions

github-actions Bot commented Sep 9, 2026 •

Copy link
Copy Markdown

Click here to review and test in web IDE: Contribute

Assisted-by: Claude Opus 4.6
Signed-off-by: Oleksii Orel <oorel@redhat.com>
gtrivedi88 added a commit that referenced this pull request Sep 23, 2026
The dawidd6/action-download-artifact step in this workflow only
specified 'workflow', not 'run_id'. Without run_id, the action
searches for the most recent successful 'doc-content' artifact for
that workflow name across the entire repository instead of the
specific run that triggered this workflow_run event.

allow_forks defaults to false, which additionally causes the search
to skip fork-originated PR runs (every JTBD PR is opened from a
fork). The net effect: preview links for fork PRs get attributed to
whatever non-fork branch happens to have the most recent successful
build, instead of the PR that actually triggered the workflow.

Observed on PR #3143: multiple concurrently-building fork PRs
(#3143, #3151, #3153, #3155) never received their own preview link;
the '"Navigate the preview"' comment kept landing on PR #3192
(a same-repo branch push) instead, whose sticky comment was
repeatedly overwritten with unrelated deploy links throughout the
day (createdAt stayed 2026-09-09 while the body kept changing).

Fix: pin run_id to github.event.workflow_run.id so the artifact
download always resolves to the exact run that completed, and set
allow_forks: true since this workflow already executes in the base
repo's trusted context via workflow_run.

Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant