diff --git a/README.md b/README.md index 128ec81..a4f82c1 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # GitHub Copilot Enterprise Workshop > **Audience:** Enterprise developers and technical resources -> **Duration:** Full day (9:00 AM - 4:00 PM) +> **Duration:** Full day (9:00 AM - 4:15 PM) > **Prerequisites:** VS Code installed, GitHub Copilot license (Business/Enterprise), GitHub.com account --- @@ -11,15 +11,15 @@ | Time | Module | Duration | Format | |------|--------|----------:|--------| | 9:00 - 9:15 | [Welcome & Foundations](modules/module-00-welcome/) | 15 min | Presentation | -| 9:15 - 10:00 | [Module 1: Copilot in VS Code - Core Experience](modules/module-01-core-experience/) | 45 min | Demo + Hands-on | -| 10:00 - 10:15 | Break | 15 min | | -| 10:15 - 11:15 | [Module 2: Copilot Chat - Deep Dive](modules/module-02-chat-deep-dive/) | 60 min | Demo + Hands-on | -| 11:15 - 12:00 | [Module 3: Copilot on GitHub.com (GHEC)](modules/module-03-copilot-on-github/) | 45 min | Demo + Hands-on | -| 12:00 - 1:00 | Lunch | 60 min | | -| 1:00 - 2:00 | [Module 4: Customization - Instructions & Prompt Files](modules/module-04-customization/) | 60 min | Demo + Hands-on | -| 2:00 - 2:15 | Break | 15 min | | -| 2:15 - 3:30 | [Module 5: Agent Mode & Custom Agents](modules/module-05-agents/) | 75 min | Demo + Hands-on | -| 3:30 - 4:00 | [Wrap-up, Q&A & Next Steps](modules/module-06-wrapup/) | 30 min | Discussion | +| 9:15 - 10:15 | [Module 1: Copilot in VS Code - Core Experience](modules/module-01-core-experience/) | 60 min | Demo + Hands-on | +| 10:15 - 10:30 | Break | 15 min | | +| 10:30 - 11:30 | [Module 2: Copilot Chat - Deep Dive](modules/module-02-chat-deep-dive/) | 60 min | Demo + Hands-on | +| 11:30 - 12:15 | [Module 3: Copilot on GitHub.com (GHEC)](modules/module-03-copilot-on-github/) | 45 min | Demo + Hands-on | +| 12:15 - 1:15 | Lunch | 60 min | | +| 1:15 - 2:15 | [Module 4: Customization - Instructions & Prompt Files](modules/module-04-customization/) | 60 min | Demo + Hands-on | +| 2:15 - 2:30 | Break | 15 min | | +| 2:30 - 3:45 | [Module 5: Agent Mode & Custom Agents](modules/module-05-agents/) | 75 min | Demo + Hands-on | +| 3:45 - 4:15 | [Wrap-up, Q&A & Next Steps](modules/module-06-wrapup/) | 30 min | Discussion | --- @@ -30,11 +30,13 @@ - Identify the different Copilot plans (Business vs Enterprise) and their capabilities - Understand Copilot's privacy, security, and IP indemnity guarantees for enterprise use -### Module 1: Copilot in VS Code - Core Experience (45 min) +### Module 1: Copilot in VS Code - Core Experience (60 min) - Receive and accept inline code suggestions using Tab, partial accept, and next edit suggestions - Write effective comment-driven prompts that produce accurate code completions - Navigate alternative suggestions and understand when to accept, modify, or reject them - Apply Copilot code suggestions to real enterprise tasks: CRUD operations, data transformations, and boilerplate reduction +- Use GitHub Copilot on GitHub.com to generate pull request summaries and request AI-powered code reviews +- Assign issues to the Copilot Coding Agent and review its autonomously generated pull requests ### Module 2: Copilot Chat - Deep Dive (60 min) - Use Chat participants (`@workspace`, `@terminal`, `@github`), slash commands, and chat variables to craft precise prompts diff --git a/modules/module-01-core-experience/README.md b/modules/module-01-core-experience/README.md index 2ef9a4b..72108f8 100644 --- a/modules/module-01-core-experience/README.md +++ b/modules/module-01-core-experience/README.md @@ -1,6 +1,6 @@ # Module 1: Copilot in VS Code - Core Experience -> **Duration:** 45 minutes (15 min demo + 30 min hands-on) +> **Duration:** 60 minutes (20 min demo + 40 min hands-on) > **Format:** Demo + Hands-on --- @@ -13,6 +13,8 @@ By the end of this module, you will be able to: - Write effective comment-driven prompts that produce accurate code completions - Navigate alternative suggestions and understand when to accept, modify, or reject them - Apply Copilot code suggestions to real enterprise tasks: CRUD operations, data transformations, and boilerplate reduction +- Use GitHub Copilot on GitHub.com to generate pull request summaries and request AI-powered code reviews +- Assign issues to the Copilot Coding Agent and review its autonomously generated pull requests --- @@ -115,7 +117,47 @@ function createApiResponse(status, data, message) { --- -## 4. Hands-on Exercise (30 min) +## 4. GitHub Copilot Cloud Interactions (5 min demo) + +Copilot is not limited to your local editor. On **GitHub.com**, Copilot is embedded across pull requests, issues, search, and the dashboard — no editor required. + +### Pull Request Summaries + +When you open a pull request, click the **Copilot** icon in the PR description field to generate an automatic summary. Copilot analyzes the diff and produces: +- An **overview** of what changed and why +- A **file-by-file breakdown** describing each change +- **Review guidance** highlighting what a reviewer should focus on + +### Copilot Code Review + +Request a review from **Copilot** just like you would from a human reviewer: + +1. Open a pull request +2. In the **Reviewers** section, add **Copilot** as a reviewer +3. Copilot posts inline comments with findings and code suggestions + +Copilot code review uses the rules in `.github/copilot-instructions.md` to check against your team's coding standards. If this file does not exist, Copilot applies its own general best-practice guidelines. + +| Review Category | What Copilot Checks | +|-----------------|---------------------| +| **Security** | Injection risks, credential exposure, OWASP Top 10 | +| **Code quality** | Duplicate code, missing error handling, complexity | +| **Standards** | Team-defined rules from custom instructions | +| **Performance** | N+1 queries, missing caching, unnecessary allocations | + +### Copilot Coding Agent + +The Copilot coding agent lets you assign a GitHub issue to Copilot and have it autonomously implement the fix or feature: + +1. **Assign an issue to Copilot** — Copilot creates a branch and starts working +2. **Copilot opens a pull request** — Review the proposed changes as you would any PR +3. **Iterate via PR comments** — Leave feedback; Copilot revises and pushes updates + +> **Enterprise note:** The coding agent respects `.github/copilot-instructions.md` and runs CI/CD pipelines to validate its own changes. + +--- + +## 5. Hands-on Exercise (40 min) ### Exercise 1A: Complete the Order Service (JavaScript) @@ -157,6 +199,36 @@ Open a new file and write the following comment, then let Copilot generate the c */ ``` +### Exercise 1D: GitHub Copilot Cloud Interactions (10 min) + +#### Part 1: Generate a Pull Request Summary + +1. Create a new branch in this repository and make a small, meaningful code change (e.g., add a utility method to `exercises/orderService.js` or add input validation to `exercises/OrderService.java`) +2. Push the branch and open a pull request on GitHub.com +3. In the PR description field, click the **Copilot** icon (or the "Generate summary" button) +4. Review the generated summary: + - Does the "what changed" section accurately reflect your change? + - Would a reviewer find this summary useful? +5. Edit the summary to add any context Copilot missed + +#### Part 2: Request a Copilot Code Review + +1. On the same pull request, go to the **Reviewers** section on the right sidebar +2. Add **Copilot** as a reviewer +3. Wait for Copilot to analyze the PR and post review comments +4. Review Copilot's feedback: + - Are the suggestions relevant to your change? + - Did it flag anything against the standards in `.github/copilot-instructions.md`? + - How does it compare to what a human reviewer would say? + +#### Part 3: Explore the Copilot Coding Agent (Bonus) + +1. Navigate to the **Issues** tab of the repository +2. Open or create a small, well-described issue (e.g., "Add input validation to orderService.js") +3. In the **Assignees** section, assign the issue to **Copilot** +4. Watch Copilot create a branch and open a pull request +5. Review the pull request and leave a comment to request a change; observe how Copilot revises + --- ## Key Takeaways @@ -166,6 +238,8 @@ Open a new file and write the following comment, then let Copilot generate the c 3. **Partial acceptance is powerful:** Use `⌘ →` to accept word-by-word when a suggestion is mostly right 4. **Next Edit Suggestions save navigation time:** Let Copilot predict where you need to edit next 5. **Enterprise patterns are well-supported:** DTOs, repository patterns, API envelopes, and validation logic all generate reliably +6. **Copilot extends beyond the IDE:** PR summaries, AI code review, and the coding agent work directly on GitHub.com — no editor required +7. **The coding agent is an autonomous team member:** Assign an issue to Copilot and it will create a branch, implement the change, and open a PR for your review ---