Skip to content

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

Open
gtrivedi88 wants to merge 2 commits into
eclipse-che:mainfrom
gtrivedi88:jtbd-develop-category
Open

gtrivedi88 wants to merge 2 commits 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

⚡️ Deploying pull request preview...

@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 10 times, most recently from f3d4e75 to a589c66 Compare July 13, 2026 05:55
@gtrivedi88
gtrivedi88 force-pushed the jtbd-develop-category branch 4 times, most recently from ab8c408 to 9d1e78d Compare July 15, 2026 10:43
@gtrivedi88
gtrivedi88 force-pushed the jtbd-develop-category branch 2 times, most recently from d96e485 to 1f4698b Compare August 24, 2026 14:28
@gtrivedi88
gtrivedi88 force-pushed the jtbd-develop-category branch 2 times, most recently from e2de2ee to 8a09f35 Compare September 16, 2026 14:22
Move developer-facing content from end-user-guide to a new top-level
modules/develop/ Antora module. Apply JTBD titles, CQA formatting,
and zero-content-loss restructuring for Claude Code persistence files.

Co-authored-by: Cursor <cursoragent@cursor.com>
@gtrivedi88
gtrivedi88 force-pushed the jtbd-develop-category branch from 8a09f35 to 065aa2c Compare September 16, 2026 14:36
PR eclipse-che#3097 (procedures: Document GitHub Copilot Chat usage,
RomanNikitenko, merged May 18) targeted the 7.117.x release branch
directly instead of main, so this content never reached main and was
absent from every JTBD category restructure, including this Develop
PR. Forward-porting it now (Job 27: "Use AI coding assistants in your
workspace").

- Add modules/develop/pages/using-github-copilot-chat.adoc, ported
  from 7.117.x with fixes:
  - Add missing [role="_abstract"] tag
  - Reword abstract to open with "Set up" to match the title verb
  - Convert 1 inline IMPORTANT: admonition to block-delimited format
  - Replace "Kubernetes object" with the {kubernetes} attribute
  - Fix RedHat.TermsWarnings/Using Vale warnings (may->might,
    appears->is displayed, using->by using)
- Nest it under microsoft-visual-studio-code-open-source-ide.adoc in
  modules/develop/nav.adoc, matching its original 7.117.x placement
- On microsoft-visual-studio-code-open-source-ide.adoc (CONCEPT):
  move the pre-existing Open VSX registry link + the new Copilot Chat
  link out of body text into a proper
  [role="_additional-resources"] .Additional resources block
  (Parameter 2a), with a plain-text bridge sentence in the body
  pointing to it (Parameter 2b). Keep the existing
  xref:administration-guide:extensions-for-microsoft-visual-studio-...
  target as-is -- that page still lives at that path on main and in
  this branch; it only moves once PR eclipse-che#3143 (Extend) merges, at which
  point a follow-up xref fix (matching the eclipse-che#3178 precedent) will be
  needed after that merge, not before.

NOTE: :copilot-ext-ver: is still pinned to 0.36.2 from the 7.117.x
(DS 3.28 / Che 7.117) era. Needs SME confirmation that this version
is still current/compatible on 7.122.x before merge.

Vale: 0 errors on all 3 changed files. Remaining warnings are on
functional GitHub/Open VSX links and pre-existing URL paths.

Co-authored-by: Cursor <cursoragent@cursor.com>
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