Skip to content

fix: apply JTBD titles to all Discover pages#3150

Open
gtrivedi88 wants to merge 1 commit into
eclipse-che:mainfrom
gtrivedi88:fix-discover-jtbd-titles
Open

fix: apply JTBD titles to all Discover pages#3150
gtrivedi88 wants to merge 1 commit into
eclipse-che:mainfrom
gtrivedi88:fix-discover-jtbd-titles

Conversation

@gtrivedi88

Copy link
Copy Markdown
Contributor

What does this pull request change?

Reworks 10 page titles and 2 subsection headings in the Discover module from vague/feature-focused to JTBD purpose noun phrases, matching downstream.

10 page title changes:

  • Gateway -> Gateway and request routing
  • User workspaces -> What developers get in a workspace
  • Server components -> What runs on your cluster
  • Che operator -> Operator and lifecycle management
  • DevWorkspace Operator overview -> DevWorkspace Operator and workspace pods
  • Devfile registry -> Devfile registry and workspace templates
  • Che architecture -> How the components fit together
  • User dashboard -> Dashboard and workspace management
  • Che server -> Server and namespace provisioning
  • Plugin registry -> Plug-in registry and editor definitions

2 subsection heading changes (devworkspace-operator.adoc):

  • Configuring the devworkspace-controller-manager deployment -> devworkspace-controller-manager deployment
  • Configuring the devworkspace-webhook-server deployment -> devworkspace-webhook-server deployment

Zero content loss — title changes only.

Made with Cursor

@gtrivedi88
gtrivedi88 requested review from a team, deerskindoll and mkuznyetsov as code owners July 3, 2026 11:28
@gtrivedi88
gtrivedi88 requested a review from amisevsk July 3, 2026 11:28
@github-actions

github-actions Bot commented Jul 3, 2026

Copy link
Copy Markdown

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

@github-actions

github-actions Bot commented Jul 3, 2026

Copy link
Copy Markdown

Click here to review and test in web IDE: Contribute

@gtrivedi88
gtrivedi88 force-pushed the fix-discover-jtbd-titles branch 2 times, most recently from 7e99ebe to 7d0ba26 Compare July 7, 2026 06:01
@gtrivedi88
gtrivedi88 force-pushed the fix-discover-jtbd-titles branch 3 times, most recently from e0773b4 to be47162 Compare July 15, 2026 11:20
Apply JTBD-compliant titles, sync body content with downstream, add
bridge sentences, and remove generic persona snippets from all
Discover pages.

Title changes (10 pages):
- Architecture overview -> How the components fit together
- Server components -> What runs on your cluster
- Che operator -> Operator and lifecycle management
- DevWorkspace Operator overview -> DevWorkspace Operator and workspace pods
- Gateway -> Gateway and request routing
- User dashboard -> Dashboard and workspace management
- Che server -> Server and namespace provisioning
- Plugin registry -> Plug-in registry and editor definitions
- Devfile registry -> Devfile registry and workspace templates
- User workspaces -> What developers get in a workspace

Subsection heading changes (devworkspace-operator.adoc):
- Configuring the devworkspace-controller-manager deployment
  -> devworkspace-controller-manager deployment
- Configuring the devworkspace-webhook-server deployment
  -> devworkspace-webhook-server deployment

Content sync with downstream:
- Remove redundant body text in dashboard (repeats abstract)
- Add configbump container to gateway (was missing upstream)
- Enrich server-components abstract (lists all 4 deployments)
- Add scalability guidance to who-is-che-for Enterprise section
- Fix "On-site" to "On-premises" in when-to-use-che
- Fix "operating system" to "OS" in what-problems-che-solves
- Remove em dashes from architecture-overview description/abstract
- Convert inline xrefs to prose in gateway, dashboard, che-operator
- Move inline links to Additional resources sections

Bridge sentences added (7 pages):
- what-is-che: architecture, server deployments, workspace pods
- when-to-use-che: devfile spec, samples, authoring tools
- architecture-overview: server, DWO, user workspace detail pages
- che-operator: CheCluster field reference, install guide
- gateway: access control policies, container project repositories
- plugin-registry: che-editors.yaml definitions, online instance
- who-is-che-for: scalability guidance

New pages (ported from downstream):
- what-is-che.adoc (product overview with community section)
- roles-and-tasks.adoc (persona reference with task links)

Zero content loss verified against downstream.

Co-authored-by: Cursor <cursoragent@cursor.com>
@gtrivedi88
gtrivedi88 force-pushed the fix-discover-jtbd-titles branch from be47162 to f58ba88 Compare July 15, 2026 11:51
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