Minor updates & revisions

Author: Orin-Thomas

learn-pr/advocates/challenge-github-copilot-sql/3-github-skills-exercise.yml

@@ -1,8 +1,8 @@
 ### YamlMime:ModuleUnit
 uid: learn.challenge-github-copilot-with-sql.github-skills-exercise
-title: GitHub skills exercise
+title: Hands-on exercise - Challenging GitHub Copilot with SQL
 metadata:
-  title: GitHub skills exercise
+  title: Hands-on exercise - Challenging GitHub Copilot with SQL
   description: Learn how to apply advanced GitHub Copilot features to interact with an application that uses complex SQL queries.
   ms.date: 06/25/2025
   author: Orin-Thomas

learn-pr/advocates/challenge-github-copilot-sql/includes/2-introduction-github-copilot-codespaces.md

@@ -32,9 +32,7 @@ You can also use the terminal pane within a GitHub Codespace to run commands, su
 
 ![A screenshot showing a python script being called from a GitHub codespace](../media/run-python-terminal.svg)
 
-## Customizing GitHub Codespaces
-
-You can customize your project for GitHub Codespaces by committing configuration files to your repository (also known as configuration-as-code), which creates a repeatable codespace configuration for all users of your project. Each codespace you create is hosted by GitHub in a Docker container that runs on a virtual machine. You can choose the type of virtual machine you want to use depending on the resources you need.
+## Creating a GitHub Codespace
 
 To begin developing using GitHub Codespaces, you can create a codespace from a template or from any branch or commit in a GitHub repository. When you create a codespace from a template, you can start from a blank template or choose a template suitable for the work you're doing.
 
@@ -49,9 +47,13 @@ To open a codespace from your GitHub account, start at the landing page of your
 
 ![A screenshot showing how to open a GitHub Codespace from a GitHub repository](../media/open-codespace-repository.svg)
 
+## Customizing GitHub Codespaces
+
+You can customize your project for GitHub Codespaces by committing configuration files to your repository (also known as configuration-as-code), which creates a repeatable codespace configuration for all users of your project. Each codespace you create is hosted by GitHub in a Docker container that runs on a virtual machine. You can choose the type of virtual machine you want to use depending on the resources you need.
+
 You can configure the development container for a repository so that any codespace created for that repository gives you a tailored development environment, complete with all the tools and runtimes you need to work on a specific project. A development container file is a JSON file that lets you customize the default container image that runs your codespace. You can use this JSON file to configure VS Code settings, run custom code, manage network traffic port forwarding, and configure other settings. 
 
-## Understanding GitHub Copilot in GitHub Codespaces
+## GitHub Copilot in GitHub Codespaces
 
 One of the tools you can use within a GitHub Codespace is GitHub Copilot.  You can verify that GitHub Copilot and Copilot Chat are available in your GitHub Codespaces environment by checking the Extensions tab and searching for GitHub Copilot and choosing the Install option if GitHub Copilot isn't already present.
 

learn-pr/advocates/challenge-github-copilot-sql/includes/2-working-with-sql-using-github-copilot.md

@@ -16,24 +16,20 @@ GitHub Copilot provides better outcomes when your prompts are more specific. If
 
 For example, you could use GitHub Copilot to provide you with the SQL code to create a table that included columns for first name, last name, date of birth, favorite movie, and pet name by issuing the following prompt:
 
-```
-@workspace Please provide me with the SQL code to create a table that included columns for first name, last name, date of birth, favorite movie and pet name
-```
+_@workspace Please provide me with the SQL code to create a table that included columns for first name, last name, date of birth, favorite movie and pet name_
 
 ![A screenshot a GitHub Copilot prompt related to the creation of a table in SQL.](../media/create-table.svg)
 
 ## Understanding an application that includes SQL
 
 For example, if you opened a codespace were presented with an application that included SQL code, you could query GitHub Copilot with the following prompt to understand more about the project in the following manner:
 
-```
-@workspace Please briefly explain the structure of this project.
-What should I do to run it?
-```
+_@workspace Please briefly explain the structure of this project.
+What should I do to run it?_
 
 ![A screenshot showing GitHub Copilot's response to a query about project structure.](../media/project-structure.svg)
 
-## How to understand SQL queries and code
+## Understand SQL code
 
 You can use the /explain prompt to understand specific code. For example, a project might contain a file named complex.sql, which contains the query that is being executed in the application. To understand the contents of complex.sql, you can select it within the Explorer pane of GitHub Codespaces and then use the /explain prompt in the chat.
 
@@ -74,7 +70,7 @@ You can request that GitHub Copilot to generate SQL-based tests or assertions to
 
 GitHub Copilot can help you write tests for your application code by generating test code that covers your codebase. This includes unit tests, end-to-end tests, and tests for edge cases.
 
-## Debugging SQL errors.
+## Debugging SQL errors
 
 You can ask GitHub Copilot to help debug SQL errors or suggest fixes for common issues. For example, you can select a file or block of code and ask GitHub Copilot to locate and correct any syntax errors.  
 
@@ -86,14 +82,12 @@ You can use GitHub Copilot to generate prompts to create code that performs bett
 
 1. Have an understanding of the code. This understanding can be derived from existing interaction with GitHub Copilot.
 1. Select the original code and open GitHub Copilot Chat.
-1. Provide as much detail as possible. For example, you might provide GitHub Copilot chat with the following prompt: 
-
-```
-Given the following requirements:
-The database is SQLite and contains tables relevant to movie ratings (see the structure in complex.sql).
-The query should efficiently aggregate and return the top-rated movies by region, minimizing execution time and avoiding unnecessary operations (such as redundant CASTs, unnecessary JOINs, or SELECT DISTINCT if not needed).
-The result should include movie title, average rating, region, and any other relevant fields.
-The query must complete in under 1.5 seconds on a large dataset.
-All business logic and correctness must be preserved as in the original complex.sql.
-Write a high-performance SQL query that fulfills these requirements, and explain any optimizations you apply.
-```
+1. Provide as much detail as possible. For example, you might provide GitHub Copilot chat with the following prompt:
+
+_Given the following requirements:_
+_The database is SQLite and contains tables relevant to movie ratings (see the structure in complex.sql)._
+_The query should efficiently aggregate and return the top-rated movies by region, minimizing execution time and avoiding unnecessary operations (such as redundant CASTs, unnecessary JOINs, or SELECT DISTINCT if not needed)._
+_The result should include movie title, average rating, region, and any other relevant fields._
+_The query must complete in under 1.5 seconds on a large dataset.
+All business logic and correctness must be preserved as in the original complex.sql._
+_Write a high-performance SQL query that fulfills these requirements, and explain any optimizations you apply._

learn-pr/advocates/challenge-github-copilot-sql/includes/3-github-skills-exercise.md

@@ -1,8 +1,4 @@
-## Exercise overview
-
-In this exercise, you take the role of a developer who has been asked to examine and optimize a project written by a person who recently left the organization for another role. Their code was incompletely documented, so you have chosen to use GitHub Copilot to quickly get yourself across the code functionality and application structure.
-
-## Workshop objectives
+In this exercise, you take the role of a developer who has been asked to examine and optimize a project written by a person who recently left the organization for another role. Their code was incompletely documented, so you have chosen to use GitHub Copilot to quickly gain an understanding of the code functionality and application structure.
 
 By the end of this workshop, you will:
 
@@ -11,7 +7,7 @@ By the end of this workshop, you will:
 - Apply generic concepts that can improve suggestions and select from different strategies that can yield better results.
 - Get a clear understanding of poor prompting techniques, and how these can drastically affect the output from GitHub Copilot.
 
-## Hands-on exercise: Challenging GitHub Copilot with SQL
+## Exercise: Challenging GitHub Copilot with SQL
 
 This exercise walks you through the following steps: