Skip to content

chore: promote Upgrade to top-level Antora module (JTBD Phase 2)#3133

Merged
gtrivedi88 merged 3 commits into
eclipse-che:mainfrom
gtrivedi88:jtbd-upgrade-category
Jul 2, 2026
Merged

chore: promote Upgrade to top-level Antora module (JTBD Phase 2)#3133
gtrivedi88 merged 3 commits into
eclipse-che:mainfrom
gtrivedi88:jtbd-upgrade-category

Conversation

@gtrivedi88

Copy link
Copy Markdown
Contributor

Summary

  • Promote upgrade content from Administration Guide into modules/upgrade/
  • Follows CCS category definition: Upgrade = 'Keep the deployment current'
  • Mirrors downstream devspaces-documentation structure (shipped in DS 3.29)

Changes

  • New modules/upgrade/ with nav.adoc, 7 pages, 1 example, 1 partial
  • Updated antora.yml with upgrade nav
  • Slimmed administration-guide nav (removed upgrade section)
  • page-aliases added for backward-compatible URLs from old admin-guide and install-guide paths
  • JTBD titles applied (user goals, not feature names)

Test plan

  • Antora build succeeds
  • Old admin-guide and install-guide URLs redirect via page-aliases
  • Upgrade nav renders correctly
  • No broken xrefs across modules

Made with Cursor

@gtrivedi88 gtrivedi88 requested review from a team, deerskindoll and mkuznyetsov as code owners June 29, 2026 14:21
@gtrivedi88 gtrivedi88 requested a review from ibuziuk June 29, 2026 14:21
@github-actions

github-actions Bot commented Jun 29, 2026

Copy link
Copy Markdown

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

@github-actions

github-actions Bot commented Jun 29, 2026

Copy link
Copy Markdown

Click here to review and test in web IDE: Contribute

gtrivedi88 and others added 2 commits July 2, 2026 16:39
Move upgrade content from Administration Guide into a new
modules/upgrade/ Antora module, following the CCS 'Upgrade'
category: 'Keep the deployment current with the latest version.'

- Create modules/upgrade/ with nav, pages, examples, partials
- Move 7 pages from administration-guide
- Add page-aliases for backward-compatible redirects from old
  administration-guide: and installation-guide: paths
- Apply JTBD titles from downstream audit (user goals, not features)
- Remove upgrade section from admin-guide nav
- Add modules/upgrade/nav.adoc to antora.yml

Mirrors downstream devspaces-documentation Upgrade guide structure.

Co-authored-by: Cursor <cursoragent@cursor.com>
- Created modules/upgrade/partials/snip_persona-admin.adoc
- Per-page admin persona callout in all 6 upgrade pages
- Rebased on latest main (Discover merged)

Co-authored-by: Cursor <cursoragent@cursor.com>
@gtrivedi88 gtrivedi88 force-pushed the jtbd-upgrade-category branch from 6fba2e1 to d6a324f Compare July 2, 2026 11:10
Pre-existing broken xref — the page moved to the install module but
the snippet still used a local reference without the module prefix.

Co-authored-by: Cursor <cursoragent@cursor.com>
@gtrivedi88 gtrivedi88 merged commit 16b3373 into eclipse-che:main Jul 2, 2026
5 checks passed
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.

2 participants