Skip to content

chore: promote Configure to top-level Antora module (JTBD Phase 4)#3155

Open
gtrivedi88 wants to merge 1 commit into
eclipse-che:mainfrom
gtrivedi88:jtbd-configure-fresh
Open

chore: promote Configure to top-level Antora module (JTBD Phase 4)#3155
gtrivedi88 wants to merge 1 commit into
eclipse-che:mainfrom
gtrivedi88:jtbd-configure-fresh

Conversation

@gtrivedi88

Copy link
Copy Markdown
Contributor

What does this pull request change?

Creates a new top-level modules/configure/ Antora module by extracting all configuration content from administration-guide. Replaces stale PR #3132.

43 pages, 8 partials moved.

Nav structure (3 domain sections)

  1. Configure the platform — CheCluster CR, server components, dashboard, API
  2. Configure workspaces — namespace provisioning, workspace policies
  3. Configure networking and storage — networking, storage, fuse-overlayfs, backup

Changes

  • Administration-guide nav slimmed to security-best-practices only
  • page-aliases added for all 43 moved pages
  • antora.yml updated with configure nav

Supersedes #3132. Please close #3132 after merging this PR.

Pull Request checklist

  • No procedure changes — moves 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 6, 2026 06:54
@gtrivedi88 gtrivedi88 requested a review from ibuziuk July 6, 2026 06:55
@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown

Click here to review and test in web IDE: Contribute

@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown

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

@gtrivedi88 gtrivedi88 force-pushed the jtbd-configure-fresh branch 19 times, most recently from 5efd268 to fc627d8 Compare July 13, 2026 05:40
Create new top-level modules/configure/ Antora module by extracting all
configuration content from administration-guide. Also apply JTBD content
quality audit to Configure and Upgrade modules.

Configure module (43 pages, 8 partials):
- Nav structure: platform config, workspace config, networking & storage
- page-aliases added for all moved pages
- Image moved from discover to configure (devworkspace-config-attribute.png)

Upgrade module JTBD audit:
- Overview concept with upgrade path and pre-upgrade checklist
- Remove generic persona snippets, fix meta-commentary abstracts
- Navigation reorder to user journey progression
- Fix content types (approval strategy, web console → PROCEDURE)

Content quality fixes:
- Update :description: and :navtitle: to match JTBD standards
- Fix title: "Enable container run capabilities" → "Run nested containers"
- Update xrefs from administration-guide: to configure: across modules

Co-authored-by: Cursor <cursoragent@cursor.com>
@gtrivedi88 gtrivedi88 force-pushed the jtbd-configure-fresh branch from fc627d8 to e6825de Compare July 13, 2026 05:42
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