Skip to content

docs: replace Introduction with JTBD product overview in Discover#3131

Open
gtrivedi88 wants to merge 1 commit into
eclipse-che:mainfrom
gtrivedi88:jtbd-discover-product-overview
Open

docs: replace Introduction with JTBD product overview in Discover#3131
gtrivedi88 wants to merge 1 commit into
eclipse-che:mainfrom
gtrivedi88:jtbd-discover-product-overview

Conversation

@gtrivedi88

Copy link
Copy Markdown
Contributor

Summary

  • Replace the legacy introduction-to-eclipse-che.adoc with a structured product overview (what-is-che.adoc) that follows JTBD methodology and CQA 2.1 standards
  • Move from the now-empty modules/overview/ to modules/discover/ (completing the migration started in fix: Remove overview duplication to restore JTBD navigation flow #3124)
  • Update antora.yml start_page to discover:what-is-che.adoc

What changed

Action File
Created modules/discover/pages/what-is-che.adoc
Deleted modules/overview/pages/introduction-to-eclipse-che.adoc
Deleted modules/overview/nav.adoc
Modified modules/discover/nav.adoc
Modified antora.yml

Why

The old Introduction page was a mix of marketing bullets, community links, and technical content without clear structure. Per the JTBD restructure (see #3098, #3102):

  • Discover should orient users evaluating the platform
  • Content should follow WHY-first pattern (CQA P8)
  • The page should work as a standalone search result

The new page:

  • Starts with a JTBD-oriented abstract ("Evaluate Che as a cloud development platform...")
  • Structures content: core goals → what it provides → workspace model → community
  • Uses definition lists for scannability
  • Adds page-aliases for backward-compatible URL redirects from the old page
  • Community section is preserved (upstream-only content)

Downstream alignment

The content body (minus the community section) is identical to devspaces-documentation/topics/discover/con_what-is-devspaces.adoc which was published downstream today.

Test plan

  • Verify Antora build succeeds with new start_page
  • Verify old URLs redirect via page-aliases
  • Verify Discover nav renders correctly (what-is-che → architecture → supported-platforms)

Made with Cursor

Replace the legacy Introduction page (community links, feature bullets,
marketing copy) with a structured product overview that follows JTBD and
CQA 2.1 methodology.

New page: modules/discover/pages/what-is-che.adoc
- WHY-first abstract for search/link preview
- Core goals (onboarding, consistency, security)
- What Che provides (workspaces, IDEs, extensibility, enterprise)
- Workspace model (code + tools + runtime as one unit)
- Community section preserved at end of page

Changes:
- Delete modules/overview/ (empty after nav removal in eclipse-che#3124)
- Update antora.yml start_page to discover:what-is-che.adoc
- Update discover/nav.adoc: replace cross-module overview xref
  with local what-is-che.adoc, remove hosted-che xref (still
  accessible via its own module, not a Discover evaluation topic)
- Add page-aliases for backward-compatible URL redirects

The content body is identical to downstream devspaces-documentation
con_what-is-devspaces.adoc (minus the community section which is
upstream-only).

Co-authored-by: Cursor <cursoragent@cursor.com>
@gtrivedi88 gtrivedi88 requested review from a team, deerskindoll and mkuznyetsov as code owners June 26, 2026 11:50
@gtrivedi88 gtrivedi88 requested a review from l0rd June 26, 2026 11:50
@github-actions

Copy link
Copy Markdown

⚡️ Deploying pull request preview...

@github-actions

github-actions Bot commented Jun 26, 2026

Copy link
Copy Markdown

Click here to review and test in web IDE: Contribute

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.

1 participant