chore: create Discover category with JTBD restructure#3098
Open
gtrivedi88 wants to merge 1 commit into
Open
Conversation
gtrivedi88
requested review from
a team,
deerskindoll and
mkuznyetsov
as code owners
|
🎊 Navigate the preview: https://6a062fe5a9b0ed968b34d5b1--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>
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
1 participant
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