Skip to content

fix: Remove overview duplication to restore JTBD navigation flow#3124

Merged
gtrivedi88 merged 1 commit into
eclipse-che:mainfrom
gtrivedi88:fix-navigation-duplication
Jun 16, 2026
Merged

fix: Remove overview duplication to restore JTBD navigation flow#3124
gtrivedi88 merged 1 commit into
eclipse-che:mainfrom
gtrivedi88:fix-navigation-duplication

Conversation

@gtrivedi88

Copy link
Copy Markdown
Contributor

Problem

After merging PRs #3098 and #3102, the navigation has duplication where Introduction appears both:

  • As a top-level Overview section
  • Inside the Discover section (via cross-reference)

This violates the established JTBD methodology documented in CLAUDE.md.

Solution

Remove modules/overview/nav.adoc from main navigation to restore proper JTBD flow where:

  • Discover is first and includes Introduction + Hosted Che content via cross-references
  • Install is second per SME feedback
  • No duplication in navigation

JTBD Navigation Flow

nav:
  - modules/discover/nav.adoc      # 🔍 FIRST - includes intro content
  - modules/install/nav.adoc       # ⚙️ SECOND - per SME feedback
  - modules/end-user-guide/nav.adoc
  - modules/administration-guide/nav.adoc
  - modules/extensions/nav.adoc
  - modules/glossary/nav.adoc

This follows the documented JTBD user journey: Discover → Install → Use → Administer

Testing

  • ✅ Introduction content still accessible via Discover section
  • ✅ Start page still works (start_page: overview:introduction-to-eclipse-che.adoc)
  • ✅ No broken links
  • ✅ Proper user journey flow

Fixes navigation duplication where Introduction appeared both:
- As top-level Overview section
- Inside Discover section (via cross-reference)

Per JTBD methodology established in CLAUDE.md:
- Discover should be first (includes Introduction + Hosted Che content)
- Install should be second
- Removes duplication and follows proper user journey

Navigation flow now: Discover → Install → End User Guide → Administration → Extensions → Glossary

Co-Authored-By: Claude Sonnet 4 <noreply@anthropic.com>
@gtrivedi88 gtrivedi88 requested review from a team, deerskindoll and mkuznyetsov as code owners June 16, 2026 16:16
@gtrivedi88 gtrivedi88 requested a review from tolusha June 16, 2026 16:16
@github-actions

github-actions Bot commented Jun 16, 2026

Copy link
Copy Markdown

Click here to review and test in web IDE: Contribute

@github-actions

github-actions Bot commented Jun 16, 2026

Copy link
Copy Markdown

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

@deerskindoll deerskindoll left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

@gtrivedi88 gtrivedi88 merged commit 36ff15f into eclipse-che:main Jun 16, 2026
7 checks passed
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.

3 participants