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://6a4c9775d47fe3bb70efbc9f--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 from 7527bc9 to 8a6843a Compare July 3, 2026 11:32
Apply JTBD-compliant titles, sync body content with downstream, 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 fixes:
- Remove redundant lead-in paragraph in che-operator (repeats abstract)
- Trim 3 redundant body sentences in plugin-registry (restate abstract)
- Fix tense in plugin-registry ("is reading" -> "reads")
- Expand IDE acronym in architecture-overview (first use)
- Remove meta-commentary from server-components abstract
- Fix grammar in user-workspaces ("workspaces" -> "workspace")
- Add missing task bullets in roles-and-tasks (image caching, devfiles)
- Remove unused persona partial file

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 pre-move admin-guide commits.

Co-authored-by: Cursor <cursoragent@cursor.com>
@gtrivedi88 gtrivedi88 force-pushed the fix-discover-jtbd-titles branch from 7e99ebe to 7d0ba26 Compare July 7, 2026 06:01
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