Skip to content

docs: refresh GitHub Copilot workshop content#6

Merged
EfeSenerr merged 1 commit into
Azure-Samples:mainfrom
EfeSenerr:efesenerr/repo-refresh-plan
Jun 18, 2026
Merged

docs: refresh GitHub Copilot workshop content#6
EfeSenerr merged 1 commit into
Azure-Samples:mainfrom
EfeSenerr:efesenerr/repo-refresh-plan

Conversation

@EfeSenerr

Copy link
Copy Markdown
Member

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?

[ ] Yes
[x] No

Pull Request Type

What kind of change does this Pull Request introduce?

[ ] Bugfix
[ ] Feature
[ ] Code style update (formatting, local variables)
[x] Refactoring (no functional changes, no api changes)
[ ] Documentation content changes
[ ] Other... Please describe:

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>

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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 published docs/ 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

@EfeSenerr
EfeSenerr merged commit b548b87 into Azure-Samples:main Jun 18, 2026
1 check passed
@EfeSenerr
EfeSenerr deleted the efesenerr/repo-refresh-plan branch June 18, 2026 14:30
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