Skip to content

Conversation

@FidelusAleksander
Copy link
Contributor

Summary

This pull request updates the GitHub Copilot workshop documentation to improve clarity, modernize terminology, and enhance the learning experience for new users. The changes focus on refining explanations of Copilot features, updating step-by-step instructions, and making tips and notes more visually distinctive and helpful.

Documentation improvements and feature explanations:

  • Expanded and clarified the introduction to Copilot, including a new table summarizing Copilot's interaction modes and their best use cases, and improved descriptions of Inline Suggestions, Ask Mode, Edit Mode, Agent Mode, and Inline Chat in .github/steps/1-preparing.md.
  • Rewrote the bug introduction and Copilot theory section in .github/steps/2-first-introduction.md for a more engaging and informative start to the debugging exercise.

Step-by-step instruction updates:

  • Enhanced instructions for opening Copilot Chat, selecting Ask Mode, and interacting with prompts, including new screenshots and clearer guidance in .github/steps/1-preparing.md.
  • Updated explanations for using the terminal and Copilot's Terminal Inline Chat, emphasizing workflow continuity and adding more helpful notes in .github/steps/1-preparing.md. [1] [2]
  • Improved the explanation of Inline Chat vs Copilot Chat, and streamlined instructions for generating sample data in .github/steps/2-first-introduction.md.

Visual and accessibility enhancements:

  • Standardized tip, note, and warning formatting throughout the documentation for better visibility, using emoji and clearer language. [1] [2] [3] [4] [5] [6] [7]
  • Updated and replaced screenshots to match the latest Copilot UI and context file selection process. [1] [2]

Copilot Edit Mode and workflow improvements:

  • Added a new theory section and mermaid diagram to explain Copilot Edit Mode, clarified its differences from Agent Mode, and improved instructions for using Edit Mode to make multi-file changes in .github/steps/3-copilot-edits.md.
  • Updated activity instructions to emphasize context file selection and review process for Copilot Edit Mode, including more actionable tips and clearer next steps. [1] [2] [3]

Changes

Closes:

Task list

  • For workflow changes, I have verified the Actions workflows function as expected.
  • For content changes, I have reviewed the style guide.

FidelusAleksander and others added 29 commits October 2, 2025 17:14
Updated wording from 'lesson' to 'exercise' for clarity.
Updated notes on Copilot features and access limitations.
Added an image showing files added to context and removed help details.
@FidelusAleksander FidelusAleksander marked this pull request as ready for review October 3, 2025 13:57
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This pull request performs a comprehensive update to the GitHub Copilot workshop documentation and infrastructure to improve the learning experience. The changes modernize terminology, enhance visual formatting, and restructure the exercise flow to make Agent Mode a mandatory step rather than optional.

  • Restructured workflow organization by making Agent Mode step 4 instead of optional 3b
  • Enhanced documentation clarity with improved formatting, updated screenshots, and theory sections
  • Updated GitHub Actions workflows to use newer action versions and implement proper step validation

Reviewed Changes

Copilot reviewed 15 out of 15 changed files in this pull request and generated 2 comments.

File Description
pytest.ini Adds pytest configuration file for test discovery
.github/workflows/*.yml Updates workflow names, action versions, and adds new step 4 workflow
.github/steps/*.md Comprehensive documentation improvements with formatting, theory sections, and updated instructions

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

arilivigni and others added 2 commits October 3, 2025 10:06
@FidelusAleksander FidelusAleksander changed the title feat: make Agent mode step non optional and full exercise refresh refactor: make Agent mode step non optional and full exercise refresh Oct 3, 2025
Copy link
Member

@chriswblake chriswblake left a comment

Choose a reason for hiding this comment

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

Did a test run and everything worked for me. Only found a few minor wording tweaks.
Good updates. Thanks!

@FidelusAleksander FidelusAleksander merged commit d957940 into skills:main Oct 7, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

3 participants