Merge pull request #47848 from wwlpublish/936dcc0006e4213653f2afa36d621c892591a2d04923642714968b4bf296db2b-live

v-ccolin · web-flow · commit 9321a4fa6384 · 2024-11-08T09:39:16.000Z
Modules/M03-perform-operations-arrays-using-helper-methods-c-sharp
diff --git a/learn-pr/wwl-language/csharp-arrays-operations/1-introduction.yml b/learn-pr/wwl-language/csharp-arrays-operations/1-introduction.yml
@@ -4,7 +4,7 @@ title: Introduction
 metadata:
   title: Introduction
   description: "Introduction to the module."
-  ms.date: 10/08/2024
+  ms.date: 11/08/2024
   author: wwlpublish
   ms.author: eric
   ms.topic: unit
diff --git a/learn-pr/wwl-language/csharp-arrays-operations/10-summary.yml b/learn-pr/wwl-language/csharp-arrays-operations/10-summary.yml
@@ -4,7 +4,7 @@ title: Summary
 metadata:
   title: Summary
   description: "Summary of the module."
-  ms.date: 10/08/2024
+  ms.date: 11/08/2024
   author: wwlpublish
   ms.author: eric
   ms.topic: unit
diff --git a/learn-pr/wwl-language/csharp-arrays-operations/2-exercise-sort-reverse.yml b/learn-pr/wwl-language/csharp-arrays-operations/2-exercise-sort-reverse.yml
@@ -4,7 +4,7 @@ title: Exercise - Discover Sort() and Reverse()
 metadata:
   title: Exercise - Discover Sort() and Reverse()
   description: "Discover how to use Sort() and Reverse() to manipulate an array."
-  ms.date: 10/08/2024
+  ms.date: 11/08/2024
   author: wwlpublish
   ms.author: eric
   ms.topic: unit
diff --git a/learn-pr/wwl-language/csharp-arrays-operations/3-exercise-clear-resize.yml b/learn-pr/wwl-language/csharp-arrays-operations/3-exercise-clear-resize.yml
@@ -4,7 +4,7 @@ title: Exercise - Explore Clear() and Resize()
 metadata:
   title: Exercise - Explore Clear() and Resize()
   description: "Explore using Clear() and Resize() to remove the contents of specific elements in an array, and to add or remove elements from an array."
-  ms.date: 10/08/2024
+  ms.date: 11/08/2024
   author: wwlpublish
   ms.author: eric
   ms.topic: unit
diff --git a/learn-pr/wwl-language/csharp-arrays-operations/4-exercise-split-join.yml b/learn-pr/wwl-language/csharp-arrays-operations/4-exercise-split-join.yml
@@ -4,7 +4,7 @@ title: Exercise - Discover Split() and Join()
 metadata:
   title: Exercise - Discover Split() and Join()
   description: "Explore using Split() and Join() to split or combine elements in an array."
-  ms.date: 10/08/2024
+  ms.date: 11/08/2024
   author: wwlpublish
   ms.author: eric
   ms.topic: unit
diff --git a/learn-pr/wwl-language/csharp-arrays-operations/5-challenge-1.yml b/learn-pr/wwl-language/csharp-arrays-operations/5-challenge-1.yml
@@ -4,7 +4,7 @@ title: Exercise - Complete a challenge to reverse words in a sentence
 metadata:
   title: Exercise - Complete a challenge to reverse words in a sentence
   description: "Use the array manipulations you've learned to help you write code that will reverse the words in a sentence."
-  ms.date: 10/08/2024
+  ms.date: 11/08/2024
   author: wwlpublish
   ms.author: eric
   ms.topic: unit
diff --git a/learn-pr/wwl-language/csharp-arrays-operations/6-solution-1.yml b/learn-pr/wwl-language/csharp-arrays-operations/6-solution-1.yml
@@ -4,7 +4,7 @@ title: Review a solution to the reverse words in a sentence challenge
 metadata:
   title: Review a solution to the reverse words in a sentence challenge
   description: "Review a solution to the reverse words in a sentence challenge."
-  ms.date: 10/08/2024
+  ms.date: 11/08/2024
   author: wwlpublish
   ms.author: eric
   ms.topic: unit
diff --git a/learn-pr/wwl-language/csharp-arrays-operations/7-challenge-2.yml b/learn-pr/wwl-language/csharp-arrays-operations/7-challenge-2.yml
@@ -4,7 +4,7 @@ title: Exercise - Complete a challenge to parse a string of orders, sort the ord
 metadata:
   title: Exercise - Complete a challenge to parse a string of orders, sort the orders and tag possible errors
   description: "Use the array manipulations you've learned to help you write code that will parse a string of orders, sort the orders, and tag possible errors."
-  ms.date: 10/08/2024
+  ms.date: 11/08/2024
   author: wwlpublish
   ms.author: eric
   ms.topic: unit
diff --git a/learn-pr/wwl-language/csharp-arrays-operations/8-solution-2.yml b/learn-pr/wwl-language/csharp-arrays-operations/8-solution-2.yml
@@ -4,7 +4,7 @@ title: Review a solution to parse a string of orders, sort orders and tag possib
 metadata:
   title: Review a solution to parse a string of orders, sort orders and tag possible errors
   description: "Review a solution to parse a string of orders, sort orders and tag possible errors."
-  ms.date: 10/08/2024
+  ms.date: 11/08/2024
   author: wwlpublish
   ms.author: eric
   ms.topic: unit
diff --git a/learn-pr/wwl-language/csharp-arrays-operations/9-knowledge-check.yml b/learn-pr/wwl-language/csharp-arrays-operations/9-knowledge-check.yml
@@ -4,7 +4,7 @@ title: Knowledge check
 metadata:
   title: Knowledge check
   description: "Check what you learned in this module."
-  ms.date: 10/08/2024
+  ms.date: 11/08/2024
   author: wwlpublish
   ms.author: eric
   ms.topic: unit
diff --git a/learn-pr/wwl-language/csharp-arrays-operations/includes/1-introduction.md b/learn-pr/wwl-language/csharp-arrays-operations/includes/1-introduction.md
@@ -1,8 +1,8 @@
-Suppose you are a software developer on a team assigned to work with a logistics company. They have many needs for gathering and organizing their business data. Projects vary from tracking and reporting inventory, enabling specific data to be passed to and from business partners, and identifying possible fraudulent orders. Each project is different, but all require the processing of data. In these projects the applications will be performing data operations such as to add, delete, sort, combine, calculate, validate and format output.
+Suppose you're a software developer on a team working with a logistics company. Your task is to gather and organize their business data. You're involved in various projects, each unique but all centered around data processing. These projects include tracking and reporting inventory, exchanging data with business partners, and identifying potential fraudulent orders. The common operations across these projects are adding, deleting, sorting, combining, calculating, validating data, and formatting output.
 
-In this module, you'll use C# arrays to allow you to store sequences of values in a single data structure. Once you have data in an array, you can manipulate the order and the contents of the array. Furthermore, you'll be able to perform powerful string operations using array helper methods.
+In this module, you work with C# arrays to store sequences of values in a single data structure. Once you store data in an array, you can modify both the order and contents. Additionally, you can perform complex string operations using array helper methods.
 
-With the use of several helper methods, you'll sort the data or reverse the order of the data. You'll clear out the items in the array and resize the array to add new items. You'll convert a string into an array by splitting it into smaller strings each time you encounter a character like a comma. You'll also split a string into an array of characters. Finally, you'll join all of the elements of an array into a single string.
+You start by using helper methods to sort or reverse the data. Next, you learn how to remove items from the array and resize the array to accommodate new items. Then, you learn to convert a string into an array by splitting it into smaller strings each time a specific character, such as a comma, is encountered. The same method can also be used to split a string into an array of characters. Finally, you learn how to join all elements of an array into a single string.
 
 ## Learning objectives
 
diff --git a/learn-pr/wwl-language/csharp-arrays-operations/includes/2-exercise-sort-reverse.md b/learn-pr/wwl-language/csharp-arrays-operations/includes/2-exercise-sort-reverse.md
@@ -1,3 +1,4 @@
+
 The `Array` class contains methods that you can use to manipulate the content, arrangement, and size of an array. In this exercise, you code that performs various operations on an array of pallet identifiers. Your code could be the start of an application to track and optimize the usage of pallets for the company.
 
 ### Prepare your coding environment
@@ -29,7 +30,7 @@ This module includes hands-on activities that guide you through the process of b
     > [!NOTE]
     > This example uses **Collection expression** syntax, which was introduced in C#12.
 
-If working on your own PC, rather than in a sandbox or hosted environment, and you completed other Microsoft Learn modules in this C# series, you may have already created a project folder for code samples. If that's the case, you can skip over the next step, which is used to create a console app in the TestProject folder.
+If you completed other Microsoft Learn modules in this C# series on your own computer, you might create a project folder for code samples. If so, you can skip the next step, which involves creating a console app in the TestProject folder.
 
 1. At the Terminal command prompt, to create a new console application in a specified folder, type **dotnet new console -o ./CsharpProjects/TestProject** and then press Enter.
 
diff --git a/learn-pr/wwl-language/csharp-arrays-operations/includes/3-exercise-clear-resize.md b/learn-pr/wwl-language/csharp-arrays-operations/includes/3-exercise-clear-resize.md
@@ -1,10 +1,11 @@
-As you continue building a pallet tracker for the logistics company, suppose you also need track new pallets and remove old pallets from tracking. How can you accomplish creating tracking functionality for adding and removing pallets?
+
+As you continue to develop a pallet tracker for the logistics company, it's likely that you need to track new pallets and remove old ones from the tracking system. So, how can you create a tracking functionality that allows for the addition and removal of pallets?
 
 ## Use array methods to clear and resize an array
 
-The `Array.Clear()` method allows you to remove the contents of specific elements in your array and replace it with the array default value. For example, in a `string` array the element value cleared is replaced with `null`, when you clear a `int` array element the replacement is done with `0` (zero).
+The `Array.Clear()` method enables you to eliminate the contents of specific elements in your array, replacing them with the array's default value. For instance, if you clear an element in a `string` array, the cleared value is replaced with `null`. Similarly, when you clear an element in an `int` array, the replacement is `0` (zero).
 
-The `Array.Resize()` method adds or removes elements from your array.
+The `Array.Resize()` method, on the other hand, allows you to add or remove elements from your array.
 
 1. Delete or use the line comment operator `//` to comment out all of the code from the previous exercises.
 
@@ -43,7 +44,7 @@ The `Array.Resize()` method adds or removes elements from your array.
     > [!NOTE]
     > If you see a message saying "Couldn't find a project to run", ensure that the Terminal command prompt displays the expected TestProject folder location. For example: `C:\Users\someuser\Desktop\csharpprojects\TestProject>`
 
-    When you run the code, you'll see that the values stored in the first two elements of the array have been cleared out. In the `Length` property and the `foreach` statement, the elements still exist, but they're now empty.
+    When you run the code, you see that the values stored in the first two elements of the array are cleared out. In the `Length` property and the `foreach` statement, the elements still exist, but they're now empty.
 
     ```Output
     Clearing 2 ... count: 4
@@ -58,7 +59,7 @@ The `Array.Resize()` method adds or removes elements from your array.
 
 When you use `Array.Clear()`, the elements that were cleared no longer reference a string in memory. In fact, the element points to nothing at all. Pointing to nothing is an important concept that can be difficult to grasp at first.
 
-What if you attempt to retrieve the value of an element that was affected by the `Array.Clear()` method, could you do it?
+What if you attempt to retrieve the value of an element affected by the `Array.Clear()` method, could you do it?
 
 ### Access the value of a cleared element
 
@@ -138,7 +139,7 @@ To prove that the value stored in `pallets[0]` after being cleared is null, you'
 
     ```
 
-1. Save your code file, and then use Visual Studio Code to run your code. This time, when you run the code, you'll see a large error message. If you parse through the text, you'll see the following message:
+1. Save your code file, and then use Visual Studio Code to run your code. This time, when you run the code, you see a large error message. If you parse through the text, you see the following message:
 
     ```Output
     System.NullReferenceException: Object reference not set to an instance of an object.
@@ -147,7 +148,7 @@ To prove that the value stored in `pallets[0]` after being cleared is null, you'
 
     This exception is thrown because the attempt to call the method on the contents of the `pallets[0]` element happens before the C# Compiler has a chance to implicitly convert null to an empty string.
 
-    The moral of the story is that `Array.Clear()` will remove an array element's reference to a value if one exists. To fix this, you might check for null before attempt to print the value.
+    The moral of the story is that `Array.Clear()` removes an array element's reference to a value if one exists. To fix this, you might check for null before attempt to print the value.
 
     To avoid the error, add an `if` statement before accessing an array element that is potentially null.
 
@@ -189,7 +190,7 @@ if (pallets[0] != null)
 
     Here, you're calling the `Resize()` method passing in the `pallets` array by reference, using the `ref` keyword. In some cases, methods require you pass arguments by value (the default) or by reference (using the ref keyword). The reasons why this is necessary requires a long and complicated explanation about of how objects are managed in .NET. Unfortunately, that is beyond the scope of this module. When in doubt, you're recommended to look at Intellisense or Microsoft Docs for examples on how to properly call a given method.
 
-    In this case, you're resizing the `pallets` array from four elements to `6`. The new elements are added at the end of the current elements. The two new elements will be null until you assign a value to them.
+    In this case, you're resizing the `pallets` array from four elements to `6`. The new elements are added at the end of the current elements. The two new elements are null until you assign a value to them.
 
 1. Save your code file, and then use Visual Studio Code to run your code. When you run the code, you should see the following output.
 
@@ -278,7 +279,7 @@ Conversely, you can remove array elements using `Array.Resize()`.
 
 ### Can you remove null elements from an array?
 
-If the `Array.Resize()` method doesn't remove empty elements from an array, is there another helper method that will do the job automatically? No. The best way to empty elements from an array would be to count the number of non-null elements by iterating through each item and increment a variable (a counter). Next, you would create a second array that is the size of the counter variable. Finally, you would loop through each element in the original array and copy non-null values into the new array.
+If the `Array.Resize()` method doesn't remove empty elements from an array, is there another helper method that does the job automatically? No. The best way to empty elements from an array would be to count the number of non-null elements by iterating through each item and increment a variable (a counter). Next, you would create a second array that is the size of the counter variable. Finally, you would loop through each element in the original array and copy non-null values into the new array.
 
 ## Recap
 
diff --git a/learn-pr/wwl-language/csharp-arrays-operations/includes/4-exercise-split-join.md b/learn-pr/wwl-language/csharp-arrays-operations/includes/4-exercise-split-join.md
@@ -1,12 +1,13 @@
-As you continue your development work for a logistics company, you begin building a series of small applications.  Combined, the applications take data from one partner's system, modify the data, then pass it to an internal system in the format it requires.
+
+As you continue your development work for a logistics company, you begin building a series of small applications. These applications work together to take data from one partner's system, modify it, and then pass it to an internal system in the required format.
 
 To perform data transformation, you need to accept incoming data as a string, parse it into smaller data elements, then manipulate it to match different format required. How can you parse the string data into smaller data elements?
 
 ## String data type's Array methods
 
 The variables of type `string` have many built-in methods that convert a single string into either an array of smaller strings, or an array of individual characters.
 
-When processing data from other computer systems, sometimes it's formatted or encoded in a way that's not useful for your purposes. In these cases, you can use the `string` data type's Array methods to parse a string into an array.
+When you process data from other computer systems, sometimes it formats or encodes in a way that's not useful for your purposes. In these cases, you use the `string` data type's Array methods to parse a string into an array.
 
 ### Use the `ToCharArray()` to reverse a `string`
 
@@ -20,11 +21,11 @@ When processing data from other computer systems, sometimes it's formatted or en
 
     ```
 
-Here you use the `ToCharArray()` method to create an array of `char`, each element of the array has one character of the original string.
+In this example, the `ToCharArray()` method is used to create an array of `char`, where each element of the array represents one character of the original string.
 
 ### Reverse, then combine the char array into a new string
 
-Next, you reverse the order of the chars in the array, then use the `Write` method to combine them back into a single output.
+Next, the order of the characters in the array is reversed, and then the `Write` method is used to combine them back into a single output.
 
 1. Update your code in the Visual Studio Code Editor as follows:
 
@@ -64,7 +65,7 @@ Next, you reverse the order of the chars in the array, then use the `Write` meth
 
 ### Combine all of the chars into a new comma-separated-value string using `Join()`
 
-Perhaps you need to separate each element of the char array using a comma, as is common when working with data that is represented as ASCII text. To do that, you'll comment out the line of code you added in Step 2 and use the `String` class' `Join()` method, passing in the char you want to delimit each segment (the comma) and the array itself.
+In some cases, you might need to separate each element of the character array using a comma, which is a common practice when working with data represented as ASCII text. To do that, you comment out the line of code you added in Step 2 and use the `String` class' `Join()` method, passing in the char you want to delimit each segment (the comma) and the array itself.
 
 1. Update your code in the Visual Studio Code Editor as follows:
 
@@ -89,7 +90,7 @@ Perhaps you need to separate each element of the char array using a comma, as is
 
 ### `Split()` the comma-separated-value string into an array of strings
 
-To complete the code, you use the `Split()` method, which is for variables of type `string` to create an array of strings.
+To complete the code, the `Split()` method is used. This method is designed for variables of type `string` and creates an array of strings.
 
 1. Use the Visual Studio Code Editor to add the following lines of code at the bottom of the file:
 
@@ -125,7 +126,7 @@ To complete the code, you use the `Split()` method, which is for variables of ty
 
 1. Save your code file, and then use Visual Studio Code to run your code. 
 
-    When you run the code, you'll see the following output:
+    When you run the code, you see the following output:
 
     ```Output
     3,2,1,c,b,a
@@ -141,7 +142,7 @@ To complete the code, you use the `Split()` method, which is for variables of ty
 
 ## Recap
 
-Here's a few things to remember when working with strings and arrays:
+Here are a few key points to remember when working with strings and arrays:
 
-- Use methods like `ToCharArray()` and `Split()` to create an array
-- Use methods like `Join()`, or create a new string passing in an array of `char` to turn the array back into a single string
+- To create an array, use methods like `ToCharArray()` and `Split()`
+- To turn the array back into a single string, use methods like `Join()`, or create a new string passing in an array of `char`
diff --git a/learn-pr/wwl-language/csharp-arrays-operations/includes/5-challenge-1.md b/learn-pr/wwl-language/csharp-arrays-operations/includes/5-challenge-1.md
@@ -1,6 +1,6 @@
 Code challenges reinforce what you've learned and help you gain some confidence before continuing on.
 
-Many times you'll need to combine several of the ideas covered in this module into a single solution. You should work to decompose a larger problem into lots of mini-problems, then use the various ideas in this module to solve each mini-problem.
+Many times you need to combine several of the ideas covered in this module into a single solution. You should work to decompose a larger problem into lots of mini-problems, then use the various ideas in this module to solve each mini-problem.
 
 ## Write code to reverse each word in a message
 
@@ -15,7 +15,7 @@ Many times you'll need to combine several of the ideas covered in this module in
 
 1. Write the code necessary to reverse the letters of each word in place and display the result. 
 
-    In other words, don't just reverse every letter in the variable `pangram`. Instead, you'll need to reverse just the letters in each word, but print the reversed word in its original position in the message.
+    In other words, don't just reverse every letter in the variable `pangram`. Instead, you need to reverse just the letters in each word, but print the reversed word in its original position in the message.
 
     Your code must produce the following output:
 
diff --git a/learn-pr/wwl-language/csharp-arrays-operations/includes/6-solution-1.md b/learn-pr/wwl-language/csharp-arrays-operations/includes/6-solution-1.md
diff --git a/learn-pr/wwl-language/csharp-arrays-operations/includes/7-challenge-2.md b/learn-pr/wwl-language/csharp-arrays-operations/includes/7-challenge-2.md
diff --git a/learn-pr/wwl-language/csharp-arrays-operations/index.yml b/learn-pr/wwl-language/csharp-arrays-operations/index.yml
