Merge pull request #49755 from wwlpublish/882fb6eb904537ee56fa040133256c81cb1967f9cd5ae798fd376de9b62a7fff-live

 Modules/M03-implement-enum-struct-record-types

Author: Stacyrch140

learn-pr/wwl-azure/implement-enum-struct-record-types/1-introduction.yml

@@ -4,10 +4,12 @@ title: Introduction
 metadata:
   title: Introduction
   description: "Introduction to the module."
-  ms.date: 03/29/2025
+  ms.date: 03/31/2025
   author: wwlpublish
   ms.author: eric
   ms.topic: unit
+  ms.custom:
+  - N/A
 durationInMinutes: 1
 content: |
   [!include[](includes/1-introduction.md)]

learn-pr/wwl-azure/implement-enum-struct-record-types/2-use-enums-represent-named-constants-csharp.yml

@@ -4,10 +4,12 @@ title: Use enums to represent named constants in C#
 metadata:
   title: Use enums to represent named constants in C#
   description: "Learn how to use enums in C# to define named constants and improve code readability."
-  ms.date: 03/29/2025
+  ms.date: 03/31/2025
   author: wwlpublish
   ms.author: eric
   ms.topic: unit
+  ms.custom:
+  - N/A
 durationInMinutes: 6
 content: |
   [!include[](includes/2-use-enums-represent-named-constants-csharp.md)]

learn-pr/wwl-azure/implement-enum-struct-record-types/3-create-structs-encapsulate-data-csharp.yml

@@ -4,10 +4,12 @@ title: Create encapsulated data with structs in C#
 metadata:
   title: Create encapsulated data with structs in C#
   description: "Learn how to use structs in C# to group related data into lightweight, efficient containers."
-  ms.date: 03/29/2025
+  ms.date: 03/31/2025
   author: wwlpublish
   ms.author: eric
   ms.topic: unit
+  ms.custom:
+  - N/A
 durationInMinutes: 7
 content: |
   [!include[](includes/3-create-structs-encapsulate-data-csharp.md)]

learn-pr/wwl-azure/implement-enum-struct-record-types/4-apply-records-immutable-data-models-csharp.yml

@@ -4,10 +4,12 @@ title: Apply records for immutable data models in C#
 metadata:
   title: Apply records for immutable data models in C#
   description: "Learn how to use records in C# to create immutable data models with value-based equality."
-  ms.date: 03/29/2025
+  ms.date: 03/31/2025
   author: wwlpublish
   ms.author: eric
   ms.topic: unit
+  ms.custom:
+  - N/A
 durationInMinutes: 8
 content: |
   [!include[](includes/4-apply-records-immutable-data-models-csharp.md)]

learn-pr/wwl-azure/implement-enum-struct-record-types/5-exercise-implement-enum-struct-record-types.yml

@@ -4,10 +4,12 @@ title: Exercise - Implement enum, struct, and record types
 metadata:
   title: Exercise - Implement enum, struct, and record types
   description: "Practice implementing enums, structs, and records in C# to reinforce your understanding of these concepts."
-  ms.date: 03/29/2025
+  ms.date: 03/31/2025
   author: wwlpublish
   ms.author: eric
   ms.topic: unit
+  ms.custom:
+  - N/A
 durationInMinutes: 25
 content: |
   [!include[](includes/5-exercise-implement-enum-struct-record-types.md)]

learn-pr/wwl-azure/implement-enum-struct-record-types/6-knowledge-check.yml

@@ -4,10 +4,12 @@ title: Knowledge check
 metadata:
   title: Knowledge check
   description: "Check what you've learned in this module."
-  ms.date: 03/29/2025
+  ms.date: 03/31/2025
   author: wwlpublish
   ms.author: eric
   ms.topic: unit
+  ms.custom:
+  - N/A
 durationInMinutes: 3
 content: |
   [!include[](includes/6-knowledge-check.md)]

learn-pr/wwl-azure/implement-enum-struct-record-types/7-summary.yml

@@ -4,10 +4,12 @@ title: Summary
 metadata:
   title: Summary
   description: "Summarize the key concepts covered in this module."
-  ms.date: 03/29/2025
+  ms.date: 03/31/2025
   author: wwlpublish
   ms.author: eric
   ms.topic: unit
+  ms.custom:
+  - N/A
 durationInMinutes: 1
 content: |
   [!include[](includes/7-summary.md)]

learn-pr/wwl-azure/implement-enum-struct-record-types/includes/1-introduction.md

@@ -11,6 +11,6 @@ Imagine you're a developer on an e-commerce platform. Order statuses like 'Pendi
 ## Prerequisites
 
 - Visual Studio Code installed with the C# Dev Kit.
-- Basic knowledge of the Visual Studio Code IDE.
+- Basic knowledge of the Visual Studio Code Integrated Development Environment (IDE).
 - Basic understanding of the C# programming language.
 - Familiar with classes, abstract classes, interfaces and inheritance.

learn-pr/wwl-azure/implement-enum-struct-record-types/includes/2-use-enums-represent-named-constants-csharp.md

@@ -123,6 +123,37 @@ Console.WriteLine(today.IsWeekend()); // Outputs: True
 > [!TIP]
 > Use extension methods to enhance enums without modifying their definition, making them more versatile and reusable.
 
+## Practical example: Using enums to manage order statuses
+
+Enums are often used in applications to represent predefined values. For example, in an e-commerce application, you can use an enum to manage order statuses:
+
+```csharp
+enum OrderStatus
+{
+    Pending,
+    Shipped,
+    Delivered,
+    Cancelled
+}
+
+class Order
+{
+    public int OrderId { get; set; }
+    public OrderStatus Status { get; set; }
+
+    public void UpdateStatus(OrderStatus newStatus)
+    {
+        Status = newStatus;
+        Console.WriteLine($"Order {OrderId} status updated to {Status}");
+    }
+}
+
+var order = new Order { OrderId = 123, Status = OrderStatus.Pending };
+order.UpdateStatus(OrderStatus.Shipped);
+```
+
+This example demonstrates how to define an enum for order statuses, use it in a class, and update the status of an order. It helps beginners see how enums can be applied in a real-world scenario.
+
 ## Use object initializers with structs
 
 Define a struct with properties to group related data together and make it easier to initialize and work with instances of the struct.

learn-pr/wwl-azure/implement-enum-struct-record-types/includes/3-create-structs-encapsulate-data-csharp.md

@@ -62,7 +62,7 @@ public struct Rectangle
 
 ## Apply readonly modifier to structs for immutability
 
-Immutability ensures that once a struct is created, its data can't be changed. A struct is useful when working with data that should remain constant throughout its lifetime, such as coordinates, measurements, or configuration values. By applying the `readonly` modifier to a struct, you can enforce immutability, making your code more predictable and less prone to errors caused by unintended modifications.
+Immutability ensures that once a struct is created, its data can't be changed. A struct is useful when working with data that should remain constant throughout its lifetime, such as coordinates, or configuration values. When you apply the `readonly` modifier to a struct, you can enforce immutability, making your code more predictable and less prone to errors caused by unintended modifications.
 
 ```csharp
 public readonly struct ImmutablePoint
@@ -108,4 +108,35 @@ var point = new Point { X = 10, Y = 20 };
 > [!TIP]
 > Object initializers make your code more concise and easier to read when working with structs that have multiple properties.
 
+## Practical example: Using structs to represent points in 2D space
+
+Structs are often used to represent small, immutable data structures. For example, you can use a struct to represent a point in 2D space and calculate the distance between two points:
+
+```csharp
+public struct Point
+{
+    public int X { get; }
+    public int Y { get; }
+
+    public Point(int x, int y)
+    {
+        X = x;
+        Y = y;
+    }
+
+    public double DistanceTo(Point other)
+    {
+        int dx = X - other.X;
+        int dy = Y - other.Y;
+        return Math.Sqrt(dx * dx + dy * dy);
+    }
+}
+
+var point1 = new Point(3, 4);
+var point2 = new Point(7, 1);
+Console.WriteLine($"Distance between points: {point1.DistanceTo(point2)}");
+```
+
+This example demonstrates how to define a struct for a point, calculate the distance between two points, and use the struct in a simple program.
+
 Combining encapsulation, immutability, and object initializers enable you to create structs that are efficient, and predictable. These features help you manage related data in a clean and organized way.