Add First steps and real-world workshop categories - #185
Merged
Merged
Conversation
Add the First steps Copilot app tour adapted from James Montemagno's lab and move existing scenario workshops under Real-world development. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Copilot review overview
🟡 Changes recommended
Unresolved broken links and instructional/accessibility issues remain, including a critical CLI command error.
Get a fresh assessment by requesting another Copilot review.
Review effort: Lite
Findings: 1
Open (1)
What changed in this PR
This PR adds First steps and Real-world development workshop categories, introduces a guided Copilot app workshop, and updates routes, translations, assets, and authoring guidance.
Changes:
- Adds the First steps Copilot app workshop.
- Moves existing workshops under Real-world development.
- Updates localized content, navigation, links, and site guidance.
| File | Review summary |
|---|---|
README.md |
nit (1): Update publisher prerequisites guidance for category/workshop paths and First steps. |
docs/zh-cn/real-world-development/cli/README.md |
Reviewed; localized CLI route update. |
docs/zh-cn/real-world-development/cli/8-review.md |
moderate (2): Fix sibling workshop targets to ../vscode/ and ../cloud/. |
docs/zh-cn/real-world-development/cli/7-slash-commands.md |
moderate (1): Change the Cloud agent link to ../cloud/. |
docs/zh-cn/real-world-development/cli/0-prerequisites.md |
Reviewed; image path update. |
docs/zh-cn/real-world-development/app/README.md |
Reviewed; localized app route update. |
docs/zh-cn/real-world-development/app/8-review.md |
moderate (2): Fix sibling workshop targets to ../vscode/, ../cli/, and ../cloud/. |
docs/zh-cn/real-world-development/app/7-canvases.md |
Reviewed; image path update. |
docs/zh-cn/real-world-development/app/6-agent-merge.md |
Reviewed; image path update. |
docs/zh-cn/real-world-development/app/5-mcp-playwright.md |
moderate (1): Include the macOS Command+, shortcut. |
docs/zh-cn/real-world-development/app/4-build-filtering.md |
Reviewed; image path update. |
docs/zh-cn/real-world-development/app/3-custom-instructions.md |
Reviewed; image path update. |
docs/zh-cn/real-world-development/app/2-add-star-rating.md |
Reviewed; image path update. |
docs/zh-cn/real-world-development/app/0-prerequisites.md |
Reviewed; image path update. |
docs/zh-cn/README.md |
moderate (1): Link to the shared ../real-world-development/ landing page. |
docs/real-world-development/vscode/README.md |
Reviewed; route update. |
docs/real-world-development/vscode/images/.gitkeep |
Reviewed; preserves the image directory. |
docs/real-world-development/vscode/6-iterating.md |
moderate (1): Fix sibling workshop links to ../cli/ and ../cloud/. |
docs/real-world-development/vscode/5-managing-agents.md |
moderate (1): Add the required navigation table below frontmatter. |
docs/real-world-development/vscode/4-custom-agents.md |
Reviewed; image path update. |
docs/real-world-development/vscode/3-mcp.md |
Reviewed; image path update. |
docs/real-world-development/vscode/2-agent-mode.md |
Reviewed; image path update. |
docs/real-world-development/vscode/1-custom-instructions.md |
Reviewed; image path update. |
docs/real-world-development/vscode/0-prerequisites.md |
Reviewed; image path update. |
docs/real-world-development/README.md |
Reviewed; adds the category landing page. |
docs/real-world-development/cloud/README.md |
Reviewed; route update. |
docs/real-world-development/cloud/images/.gitkeep |
Reviewed; preserves the image directory. |
docs/real-world-development/cloud/5-iterating.md |
moderate (1): Fix sibling workshop links to ../vscode/ and ../cli/. |
docs/real-world-development/cloud/4-managing-agents.md |
Reviewed; image path update. |
docs/real-world-development/cloud/3-custom-agents.md |
Reviewed; image path update. |
docs/real-world-development/cloud/2-cloud-agent.md |
Reviewed; image path update. |
docs/real-world-development/cloud/0-prerequisites.md |
Reviewed; image path update. |
docs/real-world-development/cli/README.md |
Reviewed; route update. |
docs/real-world-development/cli/images/.gitkeep |
Reviewed; preserves the image directory. |
docs/real-world-development/cli/8-review.md |
moderate (1): Fix sibling workshop links to ../vscode/ and ../cloud/. |
docs/real-world-development/cli/7-slash-commands.md |
moderate (1): Change the Cloud agent link to ../cloud/. |
docs/real-world-development/cli/3-generating-code.md |
critical (1): Replace unavailable /models with /model.moderate (1): Document the macOS Control+backtick shortcut.nit (1): Change “core tasks needs” to use the plural verb “are.” |
docs/real-world-development/cli/0-prerequisites.md |
Reviewed; image path update. |
docs/real-world-development/app/README.md |
Reviewed; route update. |
docs/real-world-development/app/8-review.md |
moderate (1): Fix sibling workshop links to ../vscode/, ../cli/, and ../cloud/. |
docs/real-world-development/app/7-canvases.md |
Reviewed; image path update. |
docs/real-world-development/app/6-agent-merge.md |
Reviewed; image path update. |
docs/real-world-development/app/5-mcp-playwright.md |
moderate (1): Include the macOS Command+, shortcut. |
docs/real-world-development/app/4-build-filtering.md |
Reviewed; image path update. |
docs/real-world-development/app/3-custom-instructions.md |
Reviewed; image path update. |
docs/real-world-development/app/2-add-star-rating.md |
Reviewed; image path update. |
docs/real-world-development/app/0-prerequisites.md |
Reviewed; image path update. |
docs/README.md |
Reviewed; updates the English catalog landing page. |
docs/pt-br/real-world-development/cli/README.md |
Reviewed; localized CLI route update. |
docs/pt-br/real-world-development/cli/8-review.md |
moderate (2): Fix sibling workshop links to ../vscode/ and ../cloud/. |
docs/pt-br/real-world-development/cli/7-slash-commands.md |
moderate (1): Change the Cloud agent link to ../cloud/. |
docs/pt-br/real-world-development/cli/0-prerequisites.md |
Reviewed; image path update. |
docs/pt-br/real-world-development/app/README.md |
Reviewed; localized app route update. |
docs/pt-br/real-world-development/app/8-review.md |
moderate (2): Fix sibling workshop links to ../vscode/, ../cli/, and ../cloud/. |
docs/pt-br/real-world-development/app/7-canvases.md |
Reviewed; image path update. |
docs/pt-br/real-world-development/app/6-agent-merge.md |
Reviewed; image path update. |
docs/pt-br/real-world-development/app/5-mcp-playwright.md |
moderate (1): Include the macOS Command+, shortcut. |
docs/pt-br/real-world-development/app/4-build-filtering.md |
Reviewed; image path update. |
docs/pt-br/real-world-development/app/3-custom-instructions.md |
Reviewed; image path update. |
docs/pt-br/real-world-development/app/2-add-star-rating.md |
Reviewed; image path update. |
docs/pt-br/real-world-development/app/0-prerequisites.md |
Reviewed; image path update. |
docs/pt-br/README.md |
moderate (1): Link to the shared ../real-world-development/ landing page. |
docs/ko-kr/real-world-development/cli/README.md |
Reviewed; localized CLI route update. |
docs/ko-kr/real-world-development/cli/8-review.md |
moderate (2): Fix sibling workshop links to ../vscode/ and ../cloud/. |
docs/ko-kr/real-world-development/cli/7-slash-commands.md |
moderate (1): Change the Cloud agent link to ../cloud/. |
docs/ko-kr/real-world-development/cli/0-prerequisites.md |
Reviewed; image path update. |
docs/ko-kr/real-world-development/app/README.md |
Reviewed; localized app route update. |
docs/ko-kr/real-world-development/app/7-canvases.md |
Reviewed; image path update. |
docs/ko-kr/real-world-development/app/6-agent-merge.md |
Reviewed; image path update. |
docs/ko-kr/real-world-development/app/4-build-filtering.md |
Reviewed; image path update. |
docs/ko-kr/real-world-development/app/3-custom-instructions.md |
Reviewed; image path update. |
docs/ko-kr/real-world-development/app/2-add-star-rating.md |
Reviewed; image path update. |
docs/ko-kr/real-world-development/app/0-prerequisites.md |
Reviewed; image path update. |
docs/ko-kr/README.md |
moderate (1): Link to the shared ../real-world-development/ landing page. |
docs/ja-jp/real-world-development/cli/README.md |
Reviewed; localized CLI route update. |
docs/ja-jp/real-world-development/cli/8-review.md |
moderate (2): Fix sibling workshop links to ../vscode/ and ../cloud/. |
docs/ja-jp/real-world-development/cli/7-slash-commands.md |
moderate (1): Change the Cloud agent link to ../cloud/. |
docs/ja-jp/real-world-development/cli/0-prerequisites.md |
Reviewed; image path update. |
docs/ja-jp/real-world-development/app/README.md |
Reviewed; localized app route update. |
docs/ja-jp/real-world-development/app/7-canvases.md |
Reviewed; image path update. |
docs/ja-jp/real-world-development/app/6-agent-merge.md |
Reviewed; image path update. |
docs/ja-jp/real-world-development/app/4-build-filtering.md |
Reviewed; image path update. |
docs/ja-jp/real-world-development/app/3-custom-instructions.md |
Reviewed; image path update. |
docs/ja-jp/real-world-development/app/2-add-star-rating.md |
Reviewed; image path update. |
docs/ja-jp/real-world-development/app/0-prerequisites.md |
Reviewed; image path update. |
docs/ja-jp/README.md |
moderate (1): Link to the shared ../real-world-development/ landing page. |
docs/first-steps/README.md |
Reviewed; adds the First steps landing page. |
docs/first-steps/copilot-app/README.md |
Reviewed; adds workshop overview and attribution. |
docs/first-steps/copilot-app/8-review.md |
Reviewed; adds final review lesson. |
docs/first-steps/copilot-app/7-canvas.md |
moderate (2): Provide a keyboard-accessible, non-pointer alternative for moving the card. |
docs/first-steps/copilot-app/6-automations.md |
Reviewed; adds automation lesson. |
docs/first-steps/copilot-app/5-review.md |
moderate (1): Address every actionable comment or require remaining feedback to be resolved or deferred before merging. |
docs/first-steps/copilot-app/4-issues-and-sessions.md |
Reviewed; adds issue workflow lesson. |
docs/first-steps/copilot-app/3-publish.md |
Reviewed; adds publishing lesson. |
docs/first-steps/copilot-app/2-build-and-polish.md |
Reviewed; adds build lesson. |
docs/first-steps/copilot-app/1-create-workspace.md |
Reviewed; adds workspace lesson. |
docs/first-steps/copilot-app/0-prerequisites.md |
Reviewed; adds setup lesson. |
docs/es-es/real-world-development/cli/README.md |
Reviewed; localized CLI route update. |
docs/es-es/real-world-development/cli/8-review.md |
moderate (2): Fix sibling workshop links to ../vscode/ and ../cloud/. |
docs/es-es/real-world-development/cli/7-slash-commands.md |
moderate (1): Change the Cloud agent link to ../cloud/. |
docs/es-es/real-world-development/cli/0-prerequisites.md |
Reviewed; image path update. |
docs/es-es/real-world-development/app/README.md |
Reviewed; localized app route update. |
docs/es-es/real-world-development/app/8-review.md |
moderate (2): Fix sibling workshop links to ../vscode/, ../cli/, and ../cloud/. |
docs/es-es/real-world-development/app/7-canvases.md |
Reviewed; image path update. |
docs/es-es/real-world-development/app/6-agent-merge.md |
Reviewed; image path update. |
docs/es-es/real-world-development/app/5-mcp-playwright.md |
moderate (1): Include the macOS Command+, shortcut. |
docs/es-es/real-world-development/app/4-build-filtering.md |
Reviewed; image path update. |
docs/es-es/real-world-development/app/3-custom-instructions.md |
Reviewed; image path update. |
docs/es-es/real-world-development/app/2-add-star-rating.md |
Reviewed; image path update. |
docs/es-es/real-world-development/app/0-prerequisites.md |
Reviewed; image path update. |
docs/es-es/README.md |
moderate (1): Link to the shared ../real-world-development/ landing page. |
AUTHORING.md |
Reviewed; documents the new hierarchy. |
.github/workflows/content-alignment.md |
Reviewed; updates alignment examples. |
.github/skills/validate-site-playwright/SKILL.md |
Reviewed; updates route validation guidance. |
.github/skills/localizations/SKILL.md |
Reviewed; updates localization guidance. |
.github/instructions/markdown.instructions.md |
Reviewed; updates workshop path conventions. |
.github/instructions/astro.instructions.md |
Reviewed; updates content route conventions. |
.github/copilot-instructions.md |
Reviewed; documents the new workshop hierarchy. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Add accessible alternatives, correct Copilot commands and shortcuts, and clarify review and navigation guidance. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Integrate the new optional Foundry Agent series into the real-world development CLI workshop paths. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Integrate the VS Code Foundry Toolkit workshop under the real-world development category and preserve localized paths.\n\nCo-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Integrate the Copilot app Foundry Canvas workshop under the real-world development category and preserve localized paths.\n\nCo-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
8 of 9 tasks
Restructure the app tour to follow the latest First Steps with GitHub Copilot flow: inspect and test, project instructions, plan mode, Agent Merge, and optional /remote lessons. Add theme-aware SVG illustrations converted from upstream art.js. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Convert upstream labs/cli.js into eleven Markdown lessons with SVG illustrations and descriptive alt text. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Convert upstream labs/vscode.js into eleven Markdown lessons with SVG illustrations and descriptive alt text. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Order real-world development as GitHub Copilot CLI, GitHub Copilot app, GitHub Copilot cloud agent, then Visual Studio Code, and rename VS Code workshop labels to Visual Studio Code in both categories. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
GeekTrainer
added a commit
that referenced
this pull request
Sep 29, 2026
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Organizes the workshop catalog by learning depth so newcomers can begin with a guided product tour while experienced learners can continue using the existing scenario-based material. Moves the existing harnesses beneath Real-world development and adds three First steps workshops adapted from James Montemagno's First Steps with GitHub Copilot (MIT, formerly GitHub Copilot App Lab):
docs/first-steps/copilot-app/, 13 lessons): synced with the latest upstreamlabs/app.jsflow. It adds lessons for inspecting and testing, project instructions with/init, Plan mode, and an optional lesson on continuing remotely. It also adds Agent Merge to the review loop, the updated model guidance (GPT-6-Luna, then Auto), and the New → Open folder workspace flow.docs/first-steps/copilot-cli/, 11 lessons, new): converted fromlabs/cli.js. It covers/model,/init, publishing by prompt or with!commands, working issues from the side panel,/diff, parallel sessions with/worktree,/plan,/contextand/clear,/resumeand/remote,/pr createand/pr agentmerge, and/delegate.docs/first-steps/vscode/, 11 lessons, new): converted fromlabs/vscode.js. It covers the integrated browser and element picker,/init, the chat context indicator, smoke tests, publishing with Source Control and a sparkle-drafted commit message, Plan mode, GitHub MCP, issues and sessions, Create Pull Request with Copilot code review, and handing off to a cloud session through the Harness picker.It also adds 13 theme-aware SVG illustrations in
docs/_images/first-steps-*.svg, generated from upstreamlabs/art.js. Each keeps an MIT attribution comment, has descriptive alt text, and gets a caption in the lesson. The Starlight sidebar, the First steps landing page, the home catalog (English plus the five localized home pages), the root README,AUTHORING.md, and.github/copilot-instructions.mdnow list all three workshops.Type of change
website/Astro + Starlight wrapper).github/copilot-instructions.md, instructions, agents, skills)Verification
Screenshots
N/A. This change uses the existing Starlight presentation. The new SVG illustrations render inline as standard images and follow the OS light or dark preference.
Notes for reviewers
/real-world-development/. Redirects for the former top-level harness URLs are not included./first-steps/copilot-app/3-publish/and similar URLs change. These pages have not shipped tomainyet.