fix: apply JTBD titles to all Discover pages#3150
Open
gtrivedi88 wants to merge 1 commit into
Open
Conversation
gtrivedi88
requested review from
a team,
deerskindoll and
mkuznyetsov
as code owners
July 3, 2026 11:28
|
🎊 Navigate the preview: https://6a5775552f1bac07d1dbf825--eclipse-che-docs-pr.netlify.app 🎊 |
gtrivedi88
force-pushed
the
fix-discover-jtbd-titles
branch
2 times, most recently
from
July 7, 2026 06:01
7e99ebe to
7d0ba26
Compare
gtrivedi88
force-pushed
the
fix-discover-jtbd-titles
branch
3 times, most recently
from
July 15, 2026 11:20
e0773b4 to
be47162
Compare
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
force-pushed
the
fix-discover-jtbd-titles
branch
from
July 15, 2026 11:51
be47162 to
f58ba88
Compare
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
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.
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:
2 subsection heading changes (devworkspace-operator.adoc):
Zero content loss — title changes only.
Made with Cursor