docs: refresh GitHub Copilot workshop content#6
Merged
EfeSenerr merged 1 commit intoJun 18, 2026
Conversation
Update the workshop entry points, lab guidance, model guidance, and maintenance docs for the current GitHub Copilot experience. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
Pull request overview
Refreshes the GitHub Copilot workshop documentation and repo entry points to better match the current Copilot experience (labs, agentic workflows, and MCP), while cleaning up outdated/placeholder content across the workshop site and lab folders.
Changes:
- Reworks workshop docs to emphasize durable guidance (Auto model selection, review/validation, agentic workflows, MCP) and reduces hard-coded/product-volatile details.
- Adds/updates lab-level README pointers so the
labs/folders clearly defer to the publisheddocs/instructions. - Updates MkDocs metadata/navigation and modernizes the Pages deployment workflow action versions.
Reviewed changes
Copilot reviewed 28 out of 29 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| README.md | Replaces the repo landing page with a workshop-focused overview, prerequisites, and fork workflow. |
| mkdocs.yml | Updates site metadata and navigation labels for refreshed workshop structure. |
| labs/python/starwarsapi/README.md | Adds a pointer README to the published Star Wars Python workshop page. |
| labs/python/rock_paper_scissors/tests/test_game.py | Updates the inline comment describing how tests were generated. |
| labs/python/rock_paper_scissors/README.md | Replaces placeholder README with a pointer to the published Rock Paper Scissors page. |
| labs/python/rock_paper_scissors/README copy.md | Removes the duplicated placeholder README content. |
| labs/python/README.md | Adds an index README mapping Python lab folders to published instructions. |
| labs/java/starwarsapi/instructions.md | Fixes branding/capitalization and refreshes Copilot prompt guidance in the Java lab instructions. |
| labs/html/gallery/instructions.md | Refreshes branding and updates wording around agents/vision input and prompts. |
| docs/workshop-overview.md | Rewrites overview to a menu-style structure with a curated lab catalog. |
| docs/train-the-trainer.md | Replaces detailed agenda script with a trainer checklist, flow, and stable teaching tips. |
| docs/rag-extension-lab.md | Marks the RAG extension lab as a draft and adds completion/validation criteria. |
| docs/model-comparison.md | Replaces static model table with task-based guidance and links to official model docs. |
| docs/index.md | Refreshes the docs landing page with updated Copilot concepts and workshop navigation. |
| docs/hands-on/starwars-api.md | Applies copy/format updates and refreshes Copilot workflow wording for the Java lab. |
| docs/hands-on/starwars-api-python.md | Updates Python lab narrative to distinguish Ask-style vs agentic workflows and modernizes prompts. |
| docs/hands-on/rock_paper_scissors.md | Updates prompts and Copilot workflow wording; improves durability of instructions. |
| docs/hands-on/other-labs.md | Replaces internal lab table with external lab links + selection guidance and trainer tips. |
| docs/hands-on/mcp-server-starter.md | Updates formatting and embedded snippets for the MCP server quickstart-based lab. |
| docs/hands-on/mcp-fiar.md | Minor copy/format refresh for the FIAR MCP lab introduction. |
| docs/hands-on/index.md | Replaces long narrative with a concise lab matrix and trainer guidance. |
| docs/hands-on/html-gallery.md | Refreshes wording around Ask vs agentic workflows and vision-input bonus challenge steps. |
| docs/hands-on/gh-gallery-mcp.md | Updates agent/model guidance and modernizes wording around GitHub.com/MCP usage. |
| docs/future-roadmap.md | Replaces speculative roadmap content with a practical “keep current” maintenance checklist. |
| docs/customer-stories/customer-story-2.md | Minor formatting cleanup (duration/difficulty). |
| docs/customer-stories/customer-story-1.md | Minor copy/format cleanup and removes hard-coded model naming. |
| CONTRIBUTING.md | Replaces placeholder repository links/titles with the real Azure-Samples repo targets. |
| CHANGELOG.md | Replaces placeholder template with a workshop-oriented changelog note. |
| .github/workflows/deploy-mkdocs.yml | Updates checkout/setup-python action versions for MkDocs deployment. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comment on lines
878
to
881
| plugins { | ||
| kotlin("plugin.serialization") version "1.9.10" | ||
| id("com.github.johnrengelman.shadow") version "8.1.1" | ||
| id("com.GitHub.johnrengelman.shadow") version "8.1.1" | ||
| } |
Comment on lines
70
to
75
| !!! abstract "" | ||
| ``` | ||
| Create an issue in my repository to implement a Polaroid image gallery based on the designer mockup I just uploaded. The issue should contain the requirements for the Polaroid image gallery and a list of tasks to complete. The issue should emphasize the need for a 3x3 grid layout and the minimal use of javascript. | ||
|
|
||
| Create the issue in the upstream repository of this repository on github.com. I am the owner of this repository and have access to the upstream repository. | ||
| Create the issue in the upstream repository of this repository on GitHub.com. I am the owner of this repository and have access to the upstream repository. | ||
| ``` |
Comment on lines
+31
to
34
| You can ask GitHub Copilot Chat to provide you with the steps to create a Python based project with a prompt like: ``How can I create a Python based project, where I need one file for the game and another file for the testing?`` | ||
|
|
||
| You can use ``@workspace`` agent to | ||
| You can use ``@workspace`` agent to | ||
|
|
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.
Update the workshop entry points, lab guidance, model guidance, and maintenance docs for the current GitHub Copilot experience.
Purpose
Does this introduce a breaking change?
Pull Request Type
What kind of change does this Pull Request introduce?