Skip to content

chore: promote Troubleshoot to top-level Antora module (JTBD Phase 4)#3154

Open
gtrivedi88 wants to merge 1 commit into
eclipse-che:mainfrom
gtrivedi88:jtbd-troubleshoot-category
Open

chore: promote Troubleshoot to top-level Antora module (JTBD Phase 4)#3154
gtrivedi88 wants to merge 1 commit into
eclipse-che:mainfrom
gtrivedi88:jtbd-troubleshoot-category

Conversation

@gtrivedi88

Copy link
Copy Markdown
Contributor

What does this pull request change?

Creates a new top-level modules/troubleshoot/ Antora module by extracting all troubleshooting content from end-user-guide.

9 pages moved.

Nav structure (symptom-based ordering)

  1. Troubleshooting Che (overview)
  2. Viewing workspace logs (hub + CLI + console + editor)
  3. Debugging a workspace
  4. Troubleshooting slow workspaces
  5. Troubleshooting network problems
  6. Troubleshooting webview loading error

End-user-guide nav: troubleshooting section removed.
Added :page-aliases: end-user-guide:<page> for all 9 moved pages.

Pull Request checklist

  • No procedure changes — moves only
  • All pages contain :page-aliases: for backward-compatible URLs
  • Zero content loss

Made with Cursor

@gtrivedi88 gtrivedi88 requested review from a team, deerskindoll and mkuznyetsov as code owners July 6, 2026 06:27
@gtrivedi88 gtrivedi88 requested a review from tolusha July 6, 2026 06:27
@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown

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

@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown

Click here to review and test in web IDE: Contribute

@gtrivedi88 gtrivedi88 force-pushed the jtbd-troubleshoot-category branch 5 times, most recently from 19f9e87 to bf152fc Compare July 6, 2026 16:30
Create modules/troubleshoot/ with 9 pages moved from end-user-guide.
Full JTBD checklist applied using cluster-tested downstream structure.

Nav: symptom-based ordering (orient -> logs -> startup -> performance
-> network -> webview). Max 2 levels.

Titles: all rewritten to user goals (no gerunds). Examples:
- "Troubleshooting Che" -> "When something goes wrong"
- "Viewing workspaces logs" -> "Cloud Development Environment logs"
- "Debugging a workspace" -> "Diagnose workspace startup failures"
- "Troubleshooting slow workspaces" -> "Diagnose slow CDEs"

Persona: mixed (developer + admin) callout added to all pages.
Abstract: self-referential text replaced with WHAT+WHY.

Co-authored-by: Cursor <cursoragent@cursor.com>
@gtrivedi88 gtrivedi88 force-pushed the jtbd-troubleshoot-category branch from bf152fc to aac7aa9 Compare July 6, 2026 16:32
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.

2 participants