Skip to content

Fix workshop instruction issues and surface CLI workshop on GitHub Pages#2

Merged
brunoborges merged 4 commits intomainfrom
fix/workshop-instructions
Mar 24, 2026
Merged

Fix workshop instruction issues and surface CLI workshop on GitHub Pages#2
brunoborges merged 4 commits intomainfrom
fix/workshop-instructions

Conversation

@brunoborges
Copy link
Copy Markdown
Collaborator

@brunoborges brunoborges commented Mar 24, 2026

Summary

This PR fixes several issues found during a review of the workshop materials in the workshop/ directory, adds a new workshop-cli/ variant adapted for the GitHub Copilot CLI approach, and surfaces both workshops on the GitHub Pages web interface.


Part 1: Workshop Instruction Fixes (workshop/)

# File Issue Fix
1 workshop/01-prerequisites.md Broken relative URL for Java JDK download link Updated to full https://learn.microsoft.com/java/openjdk/download URL
2 workshop/01-prerequisites.md Link to non-existent configure-settings-intellij.md Updated to point to Microsoft Learn
3 workshop/02-assess.md Instruction references non-existent asset-manager directory Updated to instruct users to open the repo root
4 workshop/05-containerize.md Typo in filename: copiotmd Fixed to copilotmd
5 workshop/04-health-endpoints.md Image named with old formula terminology Added create-skill.png and updated reference

Also includes review.md documenting all findings.


Part 2: New CLI Workshop (workshop-cli/)

Adds a new workshop-cli/ folder that mirrors the existing workshop/ structure but replaces all IDE-based instructions with the GitHub Copilot CLI approach.

File Change
00-overview.md Updated title, description and steps table for the CLI workflow
01-prerequisites.md Replaced IDE/extension prereqs with Copilot CLI, Node.js 22+, npm 10+
02-assess.md Replaced assessment UI step with launching Copilot CLI and running /mcp add app-modernization
03-upgrade.md Replaced UI task button with natural language prompt: Upgrade this project to JDK 21 and Spring Boot 3.2
04-health-endpoints.md Replaced custom skill creation UI with a natural language prompt; removed the IDE-only note
05-containerize.md Replaced Tasks panel UI flow with a natural language prompt; updated closing section to reference CLI docs

The CLI workshop covers the same modernization goals (Java 8→21, Spring Boot 2→3, health endpoints, containerization) entirely from the terminal with no IDE required.


Part 3: GitHub Pages — Surface CLI Workshop (docs/)

Updates the GitHub Pages web interface to expose both workshop variants.

File Change
docs/index.html Added "🖥️ Start CLI Workshop" CTA button in the hero section; renamed the existing workshop section to "IDE Workshop (VS Code / IntelliJ)"; added a new "CLI Workshop (Terminal / No IDE)" section listing all 6 CLI steps
docs/step.html Added support for a ?variant=cli URL parameter — when set, the step viewer loads content from workshop-cli/ instead of workshop/, shows "CLI Workshop Steps" in the sidebar, and preserves the variant across all navigation (sidebar links, footer nav, and keyboard arrows)

⚡ Quickly spin up Copilot coding agent tasks from anywhere on your macOS or Windows machine with Raycast.

brunoborges and others added 3 commits March 24, 2026 13:33
- Fix broken relative JDK download link (add full Microsoft Learn URL)
- Fix IntelliJ configure-settings link to point to Microsoft Learn URL instead of missing local file
- Fix incorrect asset-manager directory reference in 02-assess.md
- Fix typo copiotmd -> copilotmd in 05-containerize.md
- Add create-skill.png and update image reference in 04-health-endpoints.md

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Replace IDE-based instructions with Copilot CLI equivalents:
- 00-overview: Updated for terminal-based CLI workflow
- 01-prerequisites: Replaced IDE/extension prereqs with Copilot CLI, Node.js 22+, npm 10+
- 02-assess: Replaced assessment UI step with starting Copilot CLI and adding the app-modernization MCP server
- 03-upgrade: Replace UI task button with natural language prompt in CLI
- 04-health-endpoints: Replace custom skill UI flow with natural language prompt in CLI
- 05-containerize: Replace Tasks panel UI flow with natural language prompt in CLI

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@brunoborges
Copy link
Copy Markdown
Collaborator Author

@copilot the CLI version of the workshop should also be surfaced on the web page (see the html for GitHub pages)

Copy link
Copy Markdown
Contributor

Copilot AI commented Mar 24, 2026

@copilot the CLI version of the workshop should also be surfaced on the web page (see the html for GitHub pages)

Done in commit 5dc99a6. The CLI workshop is now surfaced on the GitHub Pages web interface with two changes:

  1. docs/index.html: Added a "🖥️ Start CLI Workshop" CTA button in the hero section and a new "CLI Workshop (Terminal / No IDE)" section listing all 6 CLI steps, alongside the renamed "IDE Workshop (VS Code / IntelliJ)" section.

  2. docs/step.html: Added support for a ?variant=cli URL parameter — when set, the step viewer loads markdown from workshop-cli/ instead of workshop/, shows "CLI Workshop Steps" in the sidebar, and preserves the variant across all navigation (sidebar links, footer nav, and keyboard arrow keys).

Copilot AI changed the title Fix workshop instruction issues Fix workshop instruction issues and surface CLI workshop on GitHub Pages Mar 24, 2026
@brunoborges brunoborges merged commit a8d7218 into main Mar 24, 2026
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