Skip to content

chore: promote Integrate to top-level Antora module (JTBD Phase 3)#3151

Open
gtrivedi88 wants to merge 1 commit into
eclipse-che:mainfrom
gtrivedi88:jtbd-integrate-category
Open

chore: promote Integrate to top-level Antora module (JTBD Phase 3)#3151
gtrivedi88 wants to merge 1 commit into
eclipse-che:mainfrom
gtrivedi88:jtbd-integrate-category

Conversation

@gtrivedi88

Copy link
Copy Markdown
Contributor

What does this pull request change?

Creates a new top-level modules/integrate/ Antora module by extracting OAuth for Git providers (from administration-guide) and OpenShift integration + artifact repositories (from end-user-guide).

19 pages, 24 partials, 4 images moved.

Nav structure (user journey order)

  1. Give developers credential-free Git access (7 pages) -- OAuth for GitHub, GitLab, Bitbucket, Azure DevOps
  2. Manage workspaces from the command line (1 page + 5 partials) -- oc/kubectl workspace management
  3. Use Kubernetes tools with workspaces (4 pages) -- token injection, Developer Perspective, console navigation
  4. Connect workspaces to your organization's package registries (7 pages) -- Maven, Gradle, npm, Python, Go, NuGet

JTBD title rework (all 19 pages)

  • "Configuring OAuth for Git providers" -> "Give developers credential-free Git access"
  • "Configuring OAuth 2.0 for GitHub" -> "Connect GitHub with OAuth"
  • "Integrating with Kubernetes" -> "Use Kubernetes tools with workspaces"
  • "Enabling artifact repositories" -> "Connect workspaces to your organization's package registries"
  • All navtitles synced with page titles

Cross-module xref updates

  • 5 files updated across discover, install, end-user-guide, admin-guide

Added :page-aliases: for all 19 moved pages.

Pull Request checklist

  • No procedure changes -- moves and title rework only
  • All pages contain :page-aliases: for backward-compatible URLs
  • Zero content loss

Made with Cursor

@gtrivedi88 gtrivedi88 requested review from a team, deerskindoll and mkuznyetsov as code owners July 3, 2026 12:22
@gtrivedi88 gtrivedi88 requested a review from nickboldt July 3, 2026 12:22
@github-actions

github-actions Bot commented Jul 3, 2026

Copy link
Copy Markdown

Click here to review and test in web IDE: Contribute

@github-actions

github-actions Bot commented Jul 3, 2026

Copy link
Copy Markdown

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

@gtrivedi88 gtrivedi88 force-pushed the jtbd-integrate-category branch 3 times, most recently from 18f55bb to 657d7dd Compare July 7, 2026 04:56
Creates a new top-level modules/integrate/ Antora module by extracting
OAuth for Git providers (from administration-guide) and OpenShift
integration + artifact repositories (from end-user-guide).

19 pages, 24 partials, 4 images moved.

Content synced with downstream (devspaces-documentation jtbd-integrate):
- All titles use JTBD imperative verbs (no gerunds)
- Abstracts follow WHAT+WHY pattern
- Prerequisites use "You have..." completed-state wording
- Procedure steps use "Create" for resource creation
- .Verification sections added to OAuth applying procedures

Co-authored-by: Cursor <cursoragent@cursor.com>
@gtrivedi88 gtrivedi88 force-pushed the jtbd-integrate-category branch from 657d7dd to 2d4dd8f Compare July 7, 2026 05:03
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