Add First steps and real-world workshop categories - #185
Open
GeekTrainer wants to merge 1 commit into
Open
GeekTrainer wants to merge 1 commit into
GeekTrainer wants to merge 1 commit into
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.
| 1. Select **New session** for the Canvas. | ||
| 2. Choose the `space-quiz` project. | ||
| 3. Explore the issue board. | ||
| 4. Drag an issue card into the active-work column. |
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. Adds James Montemagno's GitHub Copilot App Lab as a repository-native First steps workshop and moves the existing harnesses beneath Real-world development.
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 and introduces no new visual components.
Notes for reviewers
The existing workshop URLs intentionally move beneath
/real-world-development/; redirects for the former top-level harness URLs are not included. Existing App and CLI translations move with their English source, while the new First steps workshop uses Starlight's English fallback until it is localized.The imported workshop preserves the upstream prompts and learning flow while converting the original single-page HTML lab into accessible Markdown lessons. The landing page credits James Montemagno and links to the MIT-licensed source.