Skip to content

chore: promote Develop to top-level Antora module (JTBD Phase 3)#3153

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

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

Conversation

@gtrivedi88

Copy link
Copy Markdown
Contributor

What does this pull request change?

Creates a new top-level modules/develop/ Antora module by extracting all developer workflow content from end-user-guide.

40 pages, 12 partials, 6 examples, 19 images moved.

Nav structure

  • Credentials and configurations (secrets, ConfigMaps, SSH, Git)
  • Container tooling (fuse-overlayfs, kubedock)
  • Team workflow (PR review, GitHub Actions, factory badges)
  • Persistent storage and backups
  • Prevent workspace idling
  • URL parameter reference (13 reference pages)
  • IDE selection (VS Code, JetBrains, common IDE)
  • AI coding assistants
  • Devfiles and workspace customization

Changes

  • End-user-guide slimmed to troubleshooting only
  • page-aliases added for all 40 moved pages
  • antora.yml updated with develop nav

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 05:36
@gtrivedi88 gtrivedi88 requested a review from l0rd July 6, 2026 05:36
@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown

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

@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown

Click here to review and test in web IDE: Contribute

@gtrivedi88 gtrivedi88 force-pushed the jtbd-develop-category branch 6 times, most recently from ffacb21 to 8adf531 Compare July 6, 2026 18:18
Create modules/develop/ as a new top-level Antora module with JTBD-compliant
titles, navtitles, and content structure.

Changes:
- Move 42 pages from end-user-guide to develop module
- Move 12 partials for reusable procedure content
- Move examples, images, and snippets
- Create nav.adoc with user journey ordering
- Add modules/develop to antora.yml
- Apply JTBD titles: imperative for procedures, noun phrases for concepts
- Update cross-module xrefs between develop and end-user-guide
- Add :page-aliases: for backward-compatible URLs
- Fix missing :_content-type: declarations (devfile-introduction, connect-vscode)
- Fix un-adapted downstream metadata in proc-restoring and proc-viewing-backups
- Fix duplicate procedure step in viewing-backups
- Remove forbidden persona snippet includes
- Convert vale toggles to AsciiDoc comment syntax

Co-authored-by: Cursor <cursoragent@cursor.com>
@gtrivedi88 gtrivedi88 force-pushed the jtbd-develop-category branch from 8adf531 to 502ebf4 Compare July 6, 2026 18:21
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