docs: refresh and localize App workshop - #186
Open
GeekTrainer wants to merge 12 commits into
Open
GeekTrainer wants to merge 12 commits into
GeekTrainer wants to merge 12 commits into
Conversation
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
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>
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>
Co-authored-by: Copilot <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>
9 tasks
…hop-reordered # Conflicts: # AUTHORING.md # docs/app/7-canvases.md # docs/app/9-review.md # docs/app/README.md # docs/es-es/app/7-canvases.md # docs/es-es/app/9-review.md # docs/es-es/app/README.md # docs/ja-jp/app/7-canvases.md # docs/ja-jp/app/9-review.md # docs/ja-jp/app/README.md # docs/ko-kr/app/7-canvases.md # docs/ko-kr/app/9-review.md # docs/ko-kr/app/README.md # docs/pt-br/app/7-canvases.md # docs/pt-br/app/9-review.md # docs/pt-br/app/README.md # docs/zh-cn/app/7-canvases.md # docs/zh-cn/app/9-review.md # docs/zh-cn/app/README.md # website/astro.config.mjs
Contributor
There was a problem hiding this comment.
Copilot review overview
🟡 Changes recommended
A stale authoring reference and documented grammar issues remain unresolved.
Get a fresh assessment by requesting another Copilot review.
Review effort: Lite
Findings: 7
Open (7)
What changed in this PR
Refreshes and localizes the Copilot App workshop into a multi-lesson workflow covering agent modes, skills, MCP, QA agents, Agent Merge, and canvases.
Changes:
- Reorganized English workshop lessons and navigation.
- Updated Spanish, Japanese, Korean, Brazilian Portuguese, and Simplified Chinese translations.
- Consolidated authoring guidance into the Tech Writer agent.
Outstanding review items include a stale AUTHORING.md reference and several grammar/style corrections in English and localized skills lessons.
| File | Description |
|---|---|
website/astro.config.mjs |
Updates App sidebar routes. |
docs/zh-cn/README.md |
Refreshes Chinese workshop overview. |
docs/zh-cn/app/README.md |
Updates Chinese lesson index. |
docs/zh-cn/app/8-review.md |
Updates Chinese review lesson. |
docs/zh-cn/app/8-create-pull-request.md |
Updates Chinese PR exercise. |
docs/zh-cn/app/7-qa-agent.md |
Updates Chinese QA exercise. |
docs/zh-cn/app/6-mcp-playwright.md |
Updates Chinese MCP exercise. |
docs/zh-cn/app/6-agent-merge.md |
Updates Chinese Agent Merge lesson. |
docs/zh-cn/app/5-agent-skills.md |
Updates Chinese skills exercise. |
docs/zh-cn/app/10-review.md |
Updates Chinese wrap-up lesson. |
docs/zh-cn/app/1-install-copilot-app.md |
Updates Chinese workspace guidance. |
docs/zh-cn/app/0-prerequisites.md |
Updates Chinese setup guidance. |
docs/README.md |
Refreshes English workshop overview. |
docs/pt-br/README.md |
Refreshes Portuguese workshop overview. |
docs/pt-br/app/README.md |
Updates Portuguese lesson index. |
docs/pt-br/app/8-review.md |
Updates Portuguese review lesson. |
docs/pt-br/app/8-create-pull-request.md |
Updates Portuguese PR exercise. |
docs/pt-br/app/7-qa-agent.md |
Updates Portuguese QA exercise. |
docs/pt-br/app/6-agent-merge.md |
Updates Portuguese Agent Merge lesson. |
docs/pt-br/app/10-review.md |
Updates Portuguese wrap-up lesson. |
docs/pt-br/app/1-install-copilot-app.md |
Updates Portuguese workspace guidance. |
docs/pt-br/app/0-prerequisites.md |
Updates Portuguese setup guidance. |
docs/ko-kr/README.md |
Refreshes Korean workshop overview. |
docs/ko-kr/app/8-review.md |
Updates Korean review lesson. |
docs/ko-kr/app/8-create-pull-request.md |
Updates Korean PR exercise. |
docs/ko-kr/app/7-qa-agent.md |
Updates Korean QA exercise. |
docs/ko-kr/app/6-mcp-playwright.md |
Updates Korean MCP exercise. |
docs/ko-kr/app/6-agent-merge.md |
Updates Korean Agent Merge lesson. |
docs/ko-kr/app/1-install-copilot-app.md |
Updates Korean workspace guidance. |
docs/ko-kr/app/0-prerequisites.md |
Updates Korean setup guidance. |
docs/ja-jp/README.md |
Refreshes Japanese workshop overview. |
docs/ja-jp/app/8-create-pull-request.md |
Updates Japanese PR exercise. |
docs/ja-jp/app/6-agent-merge.md |
Updates Japanese Agent Merge lesson. |
docs/ja-jp/app/1-install-copilot-app.md |
Updates Japanese workspace guidance. |
docs/ja-jp/app/0-prerequisites.md |
Updates Japanese setup guidance. |
docs/es-es/README.md |
Refreshes Spanish workshop overview. |
docs/es-es/app/README.md |
Updates Spanish lesson index. |
docs/es-es/app/8-review.md |
Updates Spanish review lesson. |
docs/es-es/app/8-create-pull-request.md |
Updates Spanish PR exercise. |
docs/es-es/app/7-qa-agent.md |
Updates Spanish QA exercise. |
docs/es-es/app/6-mcp-playwright.md |
Updates Spanish MCP exercise. |
docs/es-es/app/6-agent-merge.md |
Updates Spanish Agent Merge lesson. |
docs/es-es/app/5-agent-skills.md |
Updates Spanish skills exercise. |
docs/es-es/app/10-review.md |
Updates Spanish wrap-up lesson. |
docs/es-es/app/1-install-copilot-app.md |
Updates Spanish workspace guidance. |
docs/es-es/app/0-prerequisites.md |
Updates Spanish setup guidance. |
docs/app/README.md |
Adds the revised English lesson sequence. |
docs/app/8-review.md |
Updates the English review lesson. |
docs/app/8-create-pull-request.md |
Adds the English PR workflow. |
docs/app/7-qa-agent.md |
Adds the QA agent exercise. |
docs/app/7-canvases.md |
Updates the canvas workflow. |
docs/app/6-mcp-playwright.md |
Updates the Playwright MCP exercise. |
docs/app/6-agent-merge.md |
Updates the Agent Merge lesson. |
docs/app/5-agent-skills.md |
Adds the skills customization exercise. |
docs/app/10-review.md |
Adds the English wrap-up lesson. |
docs/app/1-install-copilot-app.md |
Updates workspace guidance. |
docs/app/0-prerequisites.md |
Updates setup guidance. |
AUTHORING.md |
Updates repository authoring guidance. |
.vscode/settings.json |
Adds spelling dictionary terms. |
.github/instructions/instructions.instructions.md |
Removes superseded instruction guidance. |
.github/agents/tech-writer.agent.md |
Adds the consolidated Tech Writer agent. |
💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
| lastUpdated: 2026-09-11 | ||
| --- | ||
|
|
||
| There's more to writing code that just writing code. We've been able to validate the code works manually, and used instructions files to ensure it follows our standards. But how about testing? Linting? All the other parts of continuous integration (CI)? |
| 4. Just below that header, add the following to ensure our results are displayed to our specifications: | ||
|
|
||
| ```markdown | ||
| Upon completion of all tests, generate a report that provides a quick overview of both success and failure of the tests, and how long they took to ran. In particular, we need sections for: |
| 4. Justo debajo, añade lo siguiente para que los resultados se muestren según nuestras especificaciones: | ||
|
|
||
| ```markdown | ||
| Upon completion of all tests, generate a report that provides a quick overview of both success and failure of the tests, and how long they took to ran. In particular, we need sections for: |
| 4. その見出しのすぐ下に次の内容を追加し、指定した形式で結果を表示するようにします。 | ||
|
|
||
| ```markdown | ||
| Upon completion of all tests, generate a report that provides a quick overview of both success and failure of the tests, and how long they took to ran. In particular, we need sections for: |
| 4. 해당 헤더 바로 아래에 다음 내용을 추가하여 원하는 형식으로 결과가 표시되게 합니다. | ||
|
|
||
| ```markdown | ||
| Upon completion of all tests, generate a report that provides a quick overview of both success and failure of the tests, and how long they took to ran. In particular, we need sections for: |
| 4. Logo abaixo desse cabeçalho, adicione o seguinte para garantir que os resultados sejam exibidos de acordo com nossas especificações: | ||
|
|
||
| ```markdown | ||
| Upon completion of all tests, generate a report that provides a quick overview of both success and failure of the tests, and how long they took to ran. In particular, we need sections for: |
| 4. 在该标题下方添加以下内容，确保按指定格式显示结果： | ||
|
|
||
| ```markdown | ||
| Upon completion of all tests, generate a report that provides a quick overview of both success and failure of the tests, and how long they took to ran. In particular, we need sections for: |
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…ainer/app-workshop-reordered # Conflicts: # AUTHORING.md # docs/README.md # docs/app/5-mcp-playwright.md # docs/es-es/README.md # docs/es-es/app/5-mcp-playwright.md # docs/es-es/real-world-development/app/10-review.md # docs/es-es/real-world-development/app/2-add-star-rating.md # docs/es-es/real-world-development/app/3-agent-modes.md # docs/es-es/real-world-development/app/3-custom-instructions.md # docs/es-es/real-world-development/app/4-build-filtering.md # docs/es-es/real-world-development/app/4-custom-instructions.md # docs/es-es/real-world-development/app/5-agent-skills.md # docs/es-es/real-world-development/app/5-mcp-playwright.md # docs/es-es/real-world-development/app/6-agent-merge.md # docs/es-es/real-world-development/app/6-mcp-playwright.md # docs/es-es/real-world-development/app/7-canvases.md # docs/es-es/real-world-development/app/7-qa-agent.md # docs/es-es/real-world-development/app/8-create-pull-request.md # docs/es-es/real-world-development/app/9-canvases.md # docs/es-es/real-world-development/app/9-review.md # docs/ja-jp/README.md # docs/ja-jp/app/5-mcp-playwright.md # docs/ja-jp/real-world-development/app/10-review.md # docs/ja-jp/real-world-development/app/2-add-star-rating.md # docs/ja-jp/real-world-development/app/3-agent-modes.md # docs/ja-jp/real-world-development/app/3-custom-instructions.md # docs/ja-jp/real-world-development/app/4-build-filtering.md # docs/ja-jp/real-world-development/app/4-custom-instructions.md # docs/ja-jp/real-world-development/app/5-agent-skills.md # docs/ja-jp/real-world-development/app/5-mcp-playwright.md # docs/ja-jp/real-world-development/app/6-agent-merge.md # docs/ja-jp/real-world-development/app/6-mcp-playwright.md # docs/ja-jp/real-world-development/app/7-canvases.md # docs/ja-jp/real-world-development/app/7-qa-agent.md # docs/ja-jp/real-world-development/app/8-create-pull-request.md # docs/ja-jp/real-world-development/app/9-canvases.md # docs/ja-jp/real-world-development/app/9-review.md # docs/ko-kr/README.md # docs/ko-kr/app/5-mcp-playwright.md # docs/ko-kr/real-world-development/app/10-review.md # docs/ko-kr/real-world-development/app/2-add-star-rating.md # docs/ko-kr/real-world-development/app/3-agent-modes.md # docs/ko-kr/real-world-development/app/3-custom-instructions.md # docs/ko-kr/real-world-development/app/4-build-filtering.md # docs/ko-kr/real-world-development/app/4-custom-instructions.md # docs/ko-kr/real-world-development/app/5-agent-skills.md # docs/ko-kr/real-world-development/app/5-mcp-playwright.md # docs/ko-kr/real-world-development/app/6-agent-merge.md # docs/ko-kr/real-world-development/app/6-mcp-playwright.md # docs/ko-kr/real-world-development/app/7-canvases.md # docs/ko-kr/real-world-development/app/7-qa-agent.md # docs/ko-kr/real-world-development/app/8-create-pull-request.md # docs/ko-kr/real-world-development/app/9-canvases.md # docs/ko-kr/real-world-development/app/9-review.md # docs/pt-br/README.md # docs/pt-br/app/5-mcp-playwright.md # docs/pt-br/real-world-development/app/10-review.md # docs/pt-br/real-world-development/app/2-add-star-rating.md # docs/pt-br/real-world-development/app/3-agent-modes.md # docs/pt-br/real-world-development/app/3-custom-instructions.md # docs/pt-br/real-world-development/app/4-build-filtering.md # docs/pt-br/real-world-development/app/4-custom-instructions.md # docs/pt-br/real-world-development/app/5-agent-skills.md # docs/pt-br/real-world-development/app/5-mcp-playwright.md # docs/pt-br/real-world-development/app/6-agent-merge.md # docs/pt-br/real-world-development/app/6-mcp-playwright.md # docs/pt-br/real-world-development/app/7-canvases.md # docs/pt-br/real-world-development/app/7-qa-agent.md # docs/pt-br/real-world-development/app/8-create-pull-request.md # docs/pt-br/real-world-development/app/9-canvases.md # docs/pt-br/real-world-development/app/9-review.md # docs/real-world-development/app/10-review.md # docs/real-world-development/app/2-add-star-rating.md # docs/real-world-development/app/3-agent-modes.md # docs/real-world-development/app/3-custom-instructions.md # docs/real-world-development/app/4-build-filtering.md # docs/real-world-development/app/4-custom-instructions.md # docs/real-world-development/app/5-agent-skills.md # docs/real-world-development/app/5-mcp-playwright.md # docs/real-world-development/app/6-agent-merge.md # docs/real-world-development/app/6-mcp-playwright.md # docs/real-world-development/app/7-canvases.md # docs/real-world-development/app/7-qa-agent.md # docs/real-world-development/app/8-create-pull-request.md # docs/real-world-development/app/9-canvases.md # docs/real-world-development/app/9-review.md # docs/zh-cn/README.md # docs/zh-cn/app/5-mcp-playwright.md # docs/zh-cn/real-world-development/app/10-review.md # docs/zh-cn/real-world-development/app/2-add-star-rating.md # docs/zh-cn/real-world-development/app/3-agent-modes.md # docs/zh-cn/real-world-development/app/3-custom-instructions.md # docs/zh-cn/real-world-development/app/4-build-filtering.md # docs/zh-cn/real-world-development/app/4-custom-instructions.md # docs/zh-cn/real-world-development/app/5-agent-skills.md # docs/zh-cn/real-world-development/app/5-mcp-playwright.md # docs/zh-cn/real-world-development/app/6-agent-merge.md # docs/zh-cn/real-world-development/app/6-mcp-playwright.md # docs/zh-cn/real-world-development/app/7-canvases.md # docs/zh-cn/real-world-development/app/7-qa-agent.md # docs/zh-cn/real-world-development/app/8-create-pull-request.md # docs/zh-cn/real-world-development/app/9-canvases.md # docs/zh-cn/real-world-development/app/9-review.md # website/astro.config.mjs
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
9 tasks
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
Refreshes the GitHub Copilot App workshop into a continuous two-PR Tailspin Toys workflow covering Plan and Autopilot modes, custom instructions, the
quality-checksskill, Playwright MCP, a QA custom agent, Agent Merge, and canvas exploration.Integrates the workshop-experience split from #185: that PR's Getting Started workshop remains authoritative under
first-steps/copilot-app, while this PR's finalized App workshop remains authoritative underreal-world-development/app. Synchronizes the Real-World App path across Spanish, Japanese, Korean, Brazilian Portuguese, and Simplified Chinese, and preserves the optional Foundry journey under the new routes.Type of change
website/Astro + Starlight wrapper).github/copilot-instructions.md, instructions, agents, skills)Verification
Notes for reviewers
The Getting Started files from #185 remain unchanged. Conflict resolution preserves this branch's finalized Real-World App lessons and translations, while adopting #185's category structure, First steps content, and related navigation.