Updated exercises

Author: buzahid

Instructions/Exercises/01-create-a-personalized-greeting.md

@@ -26,11 +26,29 @@ You'll write and run your code using an online Python editor — no installation
 
 1. The editor may contain some default code. Select all of it and delete it so you're starting with a clean, empty file.
 
+## Set up your program
+
+Before writing any logic, you'll paste a set of guiding comments into the editor. These comments act as an outline for your program — each one marks where a specific piece of code belongs.
+
+1. Copy the following comments and paste them into the editor pane:
+
+    ```python
+    # Display a welcome message
+
+    # Ask for the user's name
+
+    # Display a personalized greeting
+
+    # Ask for the user's favorite color and extend the greeting
+    ```
+
+    Remember, comments are ignored by Python when the program runs. They're just there to help you organize your code.
+
 ## Display a welcome message
 
 The first thing your program should do is greet the user when it starts. You'll use the `print()` function to display a message on the screen.
 
-1. In the editor pane, type the following code:
+1. In the editor pane, add the following line beneath the `# Display a welcome message` comment:
 
     ```python
     print("Welcome to the greeting program!")
@@ -48,9 +66,9 @@ The first thing your program should do is greet the user when it starts. You'll
 
 ## Ask for the user's name
 
-Now you'll update the program to pause and ask for the user's name. The `input()` function displays a prompt and waits for the user to type a response.
+Now you'll add code that pauses the program and asks for the user's name. The `input()` function displays a prompt and waits for the user to type a response.
 
-1. Add the following line below your existing code:
+1. Beneath the `# Ask for the user's name` comment, add the following line:
 
     ```python
     name = input("What is your name? ")
@@ -68,20 +86,12 @@ Now you'll update the program to pause and ask for the user's name. The `input()
 
 Now you'll use the `name` variable to build a personalized message. You'll do this with an **f-string** — a string that can embed variable values directly inside it using curly braces `{}`.
 
-1. Add the following line at the end of your code:
+1. Beneath the `# Display a personalized greeting` comment, add the following line:
 
     ```python
     print(f"Hello, {name}! It's great to meet you.")
     ```
 
-1. Your complete program should now look like this:
-
-    ```python
-    print("Welcome to the greeting program!")
-    name = input("What is your name? ")
-    print(f"Hello, {name}! It's great to meet you.")
-    ```
-
 1. Run the program, enter your name when prompted, and press **Enter**.
 
 1. You should see output similar to:
@@ -96,7 +106,7 @@ Now you'll use the `name` variable to build a personalized message. You'll do th
 
 Let's make the greeting more personal by also asking for the user's favorite color and including it in the message.
 
-1. Add two more lines below your existing code to ask for a favorite color and include it in a second message:
+1. Beneath the `# Ask for the user's favorite color and extend the greeting` comment, add the following two lines:
 
     ```python
     color = input("What is your favorite color? ")
@@ -106,9 +116,16 @@ Let's make the greeting more personal by also asking for the user's favorite col
 1. Your complete program should now look like this:
 
     ```python
+    # Display a welcome message
     print("Welcome to the greeting program!")
+
+    # Ask for the user's name
     name = input("What is your name? ")
+
+    # Display a personalized greeting
     print(f"Hello, {name}! It's great to meet you.")
+
+    # Ask for the user's favorite color and extend the greeting
     color = input("What is your favorite color? ")
     print(f"Great choice! {color} is a wonderful color.")
     ```
@@ -132,7 +149,7 @@ Using an AI assistant (like Copilot) is  great way to explore a programming lang
 ### Discovery 1: Create a decorative border
 
 **AI Prompt:**
-> "In Python, how can I print 20 dashes in a row without typing them all out? Can you show me an example?"
+```In Python, how can I print 20 dashes in a row without typing them all out? Can you show me an example?```
 
 **After the AI responds:** String repetition is a quick way to draw dividers or format output. Try running any examples the AI gives you in the online editor, and experiment with different characters and lengths.
 
@@ -148,7 +165,7 @@ print("-" * 20)
 ### Discovery 2: Transforming text
 
 **AI Prompt:**
-> "In Python, how can I change a string input to all uppercase, all lowercase, or title case? Can you show me examples of each?"
+```In Python, how can I change a string input to all uppercase, all lowercase, or title case? Can you show me examples of each?```
 
 ***After the AI responds:** Look closely at the code examples it provides. Try modifying your greeting program to use one of these transformations on the user's name or favorite color.
 
@@ -172,7 +189,7 @@ titlecase_name = name.title()
 
 ### Discovery 3: Printing punctuation
 
-> "In Python, what happens if I try to print a string that contains a quote character inside it? How can I do that without causing an error?"
+```In Python, what happens if I try to print a string that contains a quote character inside it? How can I do that without causing an error?```
 
 **After the AI responds:** Pay attention to the different ways it suggests for including quotes in strings. Try each method in the online editor and see how they work.
 

Instructions/Exercises/02-calculate-students-gpa.md

@@ -24,11 +24,31 @@ This exercise takes approximately **20** minutes.
 
 1. Clear any default code from the editor so you're starting with a clean file.
 
+## Set up your starter code
+
+Before writing any logic, you'll paste a set of guiding comments into the editor. These comments act as an outline for your program — each one marks where a specific piece of code belongs.
+
+1. Copy the following comments and paste them into the editor pane:
+
+    ```python
+    # Collect subject scores
+
+    # Display the entered scores
+
+    # Calculate the total, average, and GPA
+
+    # Display the results
+    ```
+
+    Remember, comments are ignored by Python when the program runs. They're just there to help you organize your code.
+
+1. Leave the code as-is for now. In the steps that follow, you'll add code beneath each comment.
+
 ## Store grades as variables
 
-You'll start by storing a student's subject scores as variables. Each score is a number out of 100.
+You'll start by storing a student's subject scores as hardcoded variables. Each score is a number out of 100.
 
-1. In the editor pane, type the following code:
+1. Beneath the `# Collect subject scores` comment, add the following lines:
 
     ```python
     math_score    = 88.0
@@ -39,7 +59,7 @@ You'll start by storing a student's subject scores as variables. Each score is a
 
     Each variable holds a **float** — a decimal number. Even though some values like `88.0` could be written as whole numbers, using floats from the start ensures your calculations return accurate decimal results later.
 
-1. Add a `print()` statement to confirm the values are stored correctly:
+1. Beneath the `# Display the entered scores` comment, add the following lines:
 
     ```python
     print("Scores entered:")
@@ -49,7 +69,7 @@ You'll start by storing a student's subject scores as variables. Each score is a
     print(f"  History: {history_score}")
     ```
 
-1. Select the **▶ (Play)** button to run the program. You should see:
+1. Select the **▶ (Run Code)** button to run the program. You should see:
 
     ```output
     Scores entered:
@@ -59,55 +79,33 @@ You'll start by storing a student's subject scores as variables. Each score is a
       History: 83.5
     ```
 
-## Calculate the total and average
+## Calculate the total, average, and GPA
+
+Now you'll use arithmetic to add up the scores, calculate the average, and convert it to a GPA on a 4.0 scale using the formula:
 
-Now you'll use arithmetic to add up the scores and calculate the average.
+$$GPA = \frac{average}{100} \times 4.0$$
 
-1. Add the following code below your existing print statements:
+1. Beneath the `# Calculate the total, average, and GPA` comment, add the following lines of code:
 
     ```python
     total = math_score + english_score + science_score + history_score
     num_subjects = 4
     average = total / num_subjects
+    gpa = (average / 100) * 4.0
     ```
 
-1. Add a print statement to display the result:
+2. Beneath the `# Display the results` comment, add the following lines of code:
 
     ```python
-    print(f"\nTotal score:   {total}")
+    print(f"\nTotal score:        {total}")
     print(f"Number of subjects: {num_subjects}")
-    print(f"Average score: {average}")
-    ```
-
-    > **Note**: `\n` inside an f-string adds a blank line before the text, which helps separate sections of output.
-
-1. Run the program. The output should now include:
-
-    ```output
-    Total score:   339.0
-    Number of subjects: 4
-    Average score: 84.75
-    ```
-
-## Convert the average to a GPA
-
-GPA is typically reported on a 4.0 scale. You'll convert the percentage average using a simple formula:
-
-$$GPA = \frac{average}{100} \times 4.0$$
-
-1. Add the following line to perform the conversion:
-
-    ```python
-    gpa = (average / 100) * 4.0
+    print(f"Average score:      {average}")
+    print(f"\nStudent GPA:        {round(gpa, 2)} / 4.0")
     ```
 
-1. Display the final GPA, rounded to two decimal places using Python's built-in `round()` function:
+    > **Note**: `\n` inside an f-string adds a blank line before the text, which helps separate sections of output. `round(gpa, 2)` rounds the GPA to two decimal places.
 
-    ```python
-    print(f"\nStudent GPA:   {round(gpa, 2)} / 4.0")
-    ```
-
-1. Run the program. Your complete output should now look like:
+3. Run the program. Your complete output should now look like this:
 
     ```output
     Scores entered:
@@ -116,18 +114,18 @@ $$GPA = \frac{average}{100} \times 4.0$$
       Science: 91.0
       History: 83.5
 
-    Total score:   339.0
+    Total score:        339.0
     Number of subjects: 4
-    Average score: 84.75
+    Average score:      84.75
 
-    Student GPA:   3.39 / 4.0
+    Student GPA:        3.39 / 4.0
     ```
 
 ## Accept grades from user input
 
 Hardcoded values are useful for testing, but a real program should accept input from the user. The `input()` function always returns a **string**, so you need to convert it to a `float` before you can use it in calculations.
 
-1. Replace the four hardcoded score variables at the top of your program with `input()` calls that collect scores from the user:
+1. Replace the four hardcoded score variables beneath the `# Collect subject scores` comment with the following `input()` calls:
 
     ```python
     print("Enter scores out of 100 for each subject:\n")
@@ -142,23 +140,27 @@ Hardcoded values are useful for testing, but a real program should accept input
 1. Keep the rest of your code exactly as it is. Your complete program should now look like this:
 
     ```python
+    # Collect subject scores
     print("Enter scores out of 100 for each subject:\n")
     math_score    = float(input("Math score:    "))
     english_score = float(input("English score: "))
     science_score = float(input("Science score: "))
     history_score = float(input("History score: "))
 
+    # Display the entered scores
     print("\nScores entered:")
     print(f"  Math:    {math_score}")
     print(f"  English: {english_score}")
     print(f"  Science: {science_score}")
     print(f"  History: {history_score}")
 
+    # Calculate the total, average, and GPA
     total = math_score + english_score + science_score + history_score
     num_subjects = 4
     average = total / num_subjects
     gpa = (average / 100) * 4.0
 
+    # Display the results
     print(f"\nTotal score:        {total}")
     print(f"Number of subjects: {num_subjects}")
     print(f"Average score:      {average}")
@@ -167,7 +169,7 @@ Hardcoded values are useful for testing, but a real program should accept input
 
 1. Run the program. When each prompt appears in the output terminal, click on it, type a score, and press **Enter**.
 
-1. Try entering the same values as before to verify your output matches the hardcoded version:
+2. Try entering the same values as before to verify your output matches the following:
 
     ```output
     Enter scores out of 100 for each subject: