Skip to content

docs: add workspace debug mode documentation#3111

Open
snecklifter wants to merge 1 commit into
eclipse-che:mainfrom
snecklifter:docs/debug-workspace-mode
Open

docs: add workspace debug mode documentation#3111
snecklifter wants to merge 1 commit into
eclipse-che:mainfrom
snecklifter:docs/debug-workspace-mode

Conversation

@snecklifter

Copy link
Copy Markdown
Contributor

Summary

  • Adds a new procedure page debugging-a-workspace.adoc documenting how to use debug mode for diagnosing workspace startup failures
  • Covers the dashboard UI actions ("Open in Debug mode" for stopped workspaces, "Restart in Debug mode" for running workspaces)
  • Documents how to inspect postStart logs at /tmp/poststart-stderr.txt and /tmp/poststart-stdout.txt
  • Includes a warning that manually patching the controller.devfile.io/debug-start annotation is overwritten by the dashboard
  • Adds the page to the troubleshooting navigation and assembly page

Test plan

  • Verify AsciiDoc renders correctly in Antora build
  • Verify all cross-references resolve (nav.adoc, troubleshooting-che.adoc)
  • Verify attribute substitutions ({prod-short}, {orch-cli}, etc.) work correctly

Related

🤖 Generated with Claude Code

@github-actions

github-actions Bot commented May 28, 2026

Copy link
Copy Markdown

Click here to review and test in web IDE: Contribute

Comment thread modules/end-user-guide/pages/debugging-a-workspace.adoc Outdated
Comment thread modules/end-user-guide/pages/debugging-a-workspace.adoc Outdated
Comment thread modules/end-user-guide/pages/debugging-a-workspace.adoc Outdated
Comment thread modules/end-user-guide/pages/debugging-a-workspace.adoc Outdated
Comment thread modules/end-user-guide/pages/debugging-a-workspace.adoc
Comment thread modules/end-user-guide/pages/debugging-a-workspace.adoc Outdated
@github-actions

github-actions Bot commented Jun 9, 2026

Copy link
Copy Markdown

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

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@snecklifter snecklifter force-pushed the docs/debug-workspace-mode branch from 9559f5b to 3974422 Compare June 9, 2026 11:23
@snecklifter snecklifter requested a review from gtrivedi88 June 9, 2026 15:04
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.

Document workspace debug mode for diagnosing startup failures

2 participants