Merge pull request #13938 from Mikejo5000/mikejo-br26

Update article on test-driven development

Author: JamesJBarnett

docs/test/media/vs-2022/test-driven-development-generate-new-type.png

@@ -1,7 +1,7 @@
 ---
 title: Test-driven development walkthrough
 description: Learn how to develop a tested method in C# using Microsoft Test Framework, which you can easily adapt for other languages or test frameworks, such as NUnit.
-ms.date: 12/04/2023
+ms.date: 5/16/2025
 ms.topic: conceptual
 ms.author: mikejo
 manager: mijacobs
@@ -18,7 +18,7 @@ This walkthrough demonstrates how to develop a tested method in C# using Microso
 
 1. Create a C# **Class Library** project for .NET or .NET Standard. This project will contain the code that we want to test. Name the project **MyMath**.
 
-2. In the same solution, add a new MSTest test project for .NET.
+2. In the same solution, add a new **MSTest** test project for .NET.
 
    In Visual Studio 2019 version 16.9, the MSTest project template name is **Unit Test Project**.
 
@@ -31,7 +31,7 @@ This walkthrough demonstrates how to develop a tested method in C# using Microso
    ![New code and test projects](../test/media/test-driven-development-ide.png)
    ::: moniker-end
 
-3. Write a simple test method that verifies the result obtained for a specific input. Add the following code to the `UnitTest1` class:
+3. In the test project, write a simple test method that verifies the result obtained for a specific input. Add the following code to the `Test1` or `UnitTest1` class:
 
    ```csharp
    [TestMethod]
@@ -51,12 +51,16 @@ This walkthrough demonstrates how to develop a tested method in C# using Microso
 
 4. Generate a type from the test code.
 
-   1. Place the cursor on `Rooter`, and then from the light bulb menu, choose **Generate type 'Rooter'** > **Generate new type**.
+   1. Place the cursor on `Rooter`, and then open the light bulb menu.
 
       ::: moniker range=">=vs-2022"
+      Choose **Generate new type**.
+
       ![Generate new type quick action](media/vs-2022/test-driven-development-generate-new-type.png)
       ::: moniker-end
       ::: moniker range="vs-2019"
+      Choose **Generate type 'Rooter'** > **Generate new type**.
+
       ![Generate new type quick action](media/test-driven-development-generate-new-type.png)
       ::: moniker-end
 
@@ -69,7 +73,7 @@ This walkthrough demonstrates how to develop a tested method in C# using Microso
       ![Generate Type dialog box in Visual Studio 2019](media/test-driven-development-generate-type-dialog.png)
       ::: moniker-end
 
-5. Generate a method from the test code. Place the cursor on `SquareRoot`, and then from the light bulb menu, choose **Generate method 'Rooter.SquareRoot'**.
+5. Generate a method from the test code. Place the cursor on `SquareRoot`, and then from the light bulb menu, choose **Generate method 'SquareRoot'** or **Generate method 'Rooter.SquareRoot'**.
 
 6. Run the unit test.
 
@@ -78,7 +82,7 @@ This walkthrough demonstrates how to develop a tested method in C# using Microso
       ::: moniker range=">=vs-2022"
       To open Test Explorer from the **Test** menu, choose **Test Explorer**.
       ::: moniker-end
-      ::: moniker range=">=vs-2022"
+      ::: moniker range="vs-2019"
       To open Test Explorer from the **Test** menu, choose **Windows** > **Test Explorer**.
       ::: moniker-end
 
@@ -193,11 +197,9 @@ To improve our confidence that the code works in all cases, add tests that try a
 
 2. In **Test Explorer**, choose **Run All**.
 
-   The method under test loops and must be canceled manually.
-
-3. Choose **Cancel** on the toolbar of **Test Explorer**.
+   The new test fails.
 
-   The test stops executing.
+   If the method under test loops, choose **Cancel** on the toolbar of **Test Explorer**. The test stops executing and fails.
 
 4. Fix the `SquareRoot` code by adding the following `if` statement at the beginning of the method: