chore: create Discover category with JTBD restructure#3098
Merged
Conversation
gtrivedi88
requested review from
a team,
deerskindoll and
mkuznyetsov
as code owners
|
🎊 Navigate the preview: https://6a31603b0edd5969030386b3--eclipse-che-docs-pr.netlify.app 🎊 |
|
Click here to review and test in web IDE: |
-525C86?logo=eclipse-che&labelColor=red){kind=icon}
gtrivedi88
force-pushed
the
jtbd-discover-category
branch
from
a2f4919 to
529d751
Compare
5 tasks
Move architecture overview, server components (7 sub-pages), user
workspaces, and supported platforms from the Administration Guide
into a new top-level Discover module. This is the first step in the
JTBD category restructure — promoting evaluation and discovery
content out of the monolithic Administration Guide.
Changes:
- Create modules/discover/ with pages, examples, and images
- Add WHY-first abstracts to all 11 pages ("To [purpose], [action]")
- Add page-aliases for backward-compatible URLs from admin-guide
- Update antora.yml: register discover nav, move architecture
diagram collector to discover module
- Update all cross-module xrefs in admin-guide, overview modules
- Remove Discover entries from administration-guide nav.adoc
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
gtrivedi88
force-pushed
the
jtbd-discover-category
branch
from
529d751 to
5362c7a
Compare
gtrivedi88
added a commit
to gtrivedi88/che-docs
that referenced
this pull request
May 14, 2026
Move all installation pages, partials, and examples from administration-guide to a new modules/install/ module, matching the downstream JTBD category structure. Create installation overview, verification, and next-steps pages. Update all cross-module xrefs and includes across admin-guide, overview, and end-user-guide. Delete dissolved wrapper pages (preparing-the-installation, permissions-to-install-che). Register discover, plan, and install module navs in antora.yml. Depends on: PR eclipse-che#3098 (Discover), PR eclipse-che#3099 (Plan) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
5 tasks
gtrivedi88
added a commit
to gtrivedi88/che-docs
that referenced
this pull request
May 14, 2026
Move all installation pages, partials, and examples from administration-guide to a new modules/install/ module, matching the downstream JTBD category structure. Create installation overview, verification, and next-steps pages. Update all cross-module xrefs and includes across admin-guide, overview, and end-user-guide. Delete dissolved wrapper pages (preparing-the-installation, permissions-to-install-che). Register discover, plan, and install module navs in antora.yml. Depends on: PR eclipse-che#3098 (Discover), PR eclipse-che#3099 (Plan) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
gtrivedi88
added a commit
to gtrivedi88/che-docs
that referenced
this pull request
May 14, 2026
Move all installation pages, partials, and examples from administration-guide to a new modules/install/ module, matching the downstream JTBD category structure. Create installation overview, verification, and next-steps pages. Update all cross-module xrefs and includes across admin-guide, overview, and end-user-guide. Delete dissolved wrapper pages (preparing-the-installation, permissions-to-install-che). Register discover, plan, and install module navs in antora.yml. Depends on: PR eclipse-che#3098 (Discover), PR eclipse-che#3099 (Plan) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
gtrivedi88
added a commit
to gtrivedi88/che-docs
that referenced
this pull request
May 18, 2026
Move all installation pages, partials, and examples from administration-guide to a new modules/install/ module, matching the downstream JTBD category structure. Create installation overview, verification, and next-steps pages. Update all cross-module xrefs and includes across admin-guide, overview, and end-user-guide. Delete dissolved wrapper pages (preparing-the-installation, permissions-to-install-che). Register discover, plan, and install module navs in antora.yml. Depends on: PR eclipse-che#3098 (Discover), PR eclipse-che#3099 (Plan) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Contributor
Author
ibuziuk
reviewed
Jun 16, 2026
ibuziuk
left a comment
ibuziuk
left a comment
Member
There was a problem hiding this comment.
Should we make Discover the first top-level section and include it there:
- Introduction to Che
- Eclipse Che hosted by Red Hat
Addresses SME feedback from ibuziuk on PR eclipse-che#3098: - Move Discover to first position in navigation - Include 'Introduction to Che' and 'Eclipse Che hosted by Red Hat' in Discover section - Remove redundant overview and hosted-che from main nav (content accessible via Discover) - Logical user flow: Discover → Use → Administer This creates a better user journey where users first discover what Eclipse Che is and explore hosted options before diving into detailed architecture. Co-Authored-By: Claude Sonnet 4 <noreply@anthropic.com>
ibuziuk
approved these changes
Jun 16, 2026
gtrivedi88
added a commit
to gtrivedi88/che-docs
that referenced
this pull request
Jun 16, 2026
Move all installation pages, partials, and examples from administration-guide to a new modules/install/ module, matching the downstream JTBD category structure. Create installation overview, verification, and next-steps pages. Update all cross-module xrefs and includes across admin-guide, overview, and end-user-guide. Delete dissolved wrapper pages (preparing-the-installation, permissions-to-install-che). Register discover, plan, and install module navs in antora.yml. Depends on: PR eclipse-che#3098 (Discover), PR eclipse-che#3099 (Plan) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
gtrivedi88
added a commit
that referenced
this pull request
Jun 16, 2026
* chore: promote Install to top-level Antora module Move all installation pages, partials, and examples from administration-guide to a new modules/install/ module, matching the downstream JTBD category structure. Create installation overview, verification, and next-steps pages. Update all cross-module xrefs and includes across admin-guide, overview, and end-user-guide. Delete dissolved wrapper pages (preparing-the-installation, permissions-to-install-che). Register discover, plan, and install module navs in antora.yml. Depends on: PR #3098 (Discover), PR #3099 (Plan) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * chore: merge Plan content into Install module, retire Plan Move calculating-che-resource-requirements, running-at-scale, and installing-the-chectl-management-tool from administration-guide into the install module. This merges what was planned as a separate Plan module (PR #3099) directly into Install, matching the downstream decision to retire the Plan guide. - Move 3 pages, 4 examples, 1 image to modules/install/ - Add running-at-scale to install/nav.adoc Requirements section - Update admin-guide nav to remove moved entries - Convert cross-module xrefs: admin-guide refs to install become local - Add plan: page-aliases for backward-compatible redirects Co-authored-by: Cursor <cursoragent@cursor.com> --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com> Co-authored-by: Cursor <cursoragent@cursor.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
modules/discover/) to house architecture and platform evaluation content:page-aliases:for backward-compatible URL redirects fromadministration-guide:antora.ymlto target the new moduleThis is the second step in the JTBD category restructure (after #3077 Install), promoting evaluation content into a purpose-driven category that aligns with the user journey: Discover → Plan → Install → Administer.
Files changed
Test plan
detect-unused-content.shpasses (no orphaned files)🤖 Generated with Claude Code