review-1

Author: v-thpra

learn-pr/language/dotnet-debug-visual-studio/includes/1-introduction.md

@@ -1,17 +1,17 @@
-Visual Studio provides very powerful tools to help you debug and diagnose issues in your applications. These tools are especially valuable for analyzing state and tracking down bugs while your application is running.
+Visual Studio provides powerful tools to help you debug and diagnose issues in your applications. These tools are especially valuable for analyzing state and tracking down bugs while your application is running.
 
 :::image source="../media/visual-studio-tools.png" alt-text="Screenshot of Visual Studio debugging tools.":::
 
-## Fix Bugs Before the Application Launches
+## Fix bugs before the application launches
 
-Suppose that you work for a team that's building a new application, but you keep finding bugs in the code. The team would like to find and fix all of these issues before the app goes live. However, the issues are too subtle or complex to diagnose just by reading the code. You're looking for additional tools and assistance to track down problems while the app is running with different inputs and parameters.
+Suppose that you work for a team that's building a new application, but you keep finding bugs in the code. The team would like to find and fix all of these issues before the app goes live. However, the issues are too subtle or complex to diagnose just by reading the code. You're looking for tools to assist you in tracking down problems while the app is running with different inputs and parameters.
 
-## What will we be doing?
+## What are you going to do?
 
-This module shows you how to use the Visual Studio debugger with a .NET program. You'll learn how to leverage common features like break points and step through your code line by line. You'll also learn how to inspect the state of your program as it executes using tools like the Watch and Locals windows. Finally, you'll also use diagnostic features like the Call Stack and Traces to review code execution in greater depth.
+This module shows you how to use the Visual Studio debugger with a .NET program. You learn how to use common features like break points and how to step through your code line by line. You also learn how to inspect the state of your program as it executes, by using tools like the Watch and Locals windows. Finally, you learn how to use diagnostic features like the Call Stack and Traces to review code execution in greater depth.
 
 :::image source="../media/visual-studio-intro.png" alt-text="Screenshot of Visual Studio debugging in action.":::
 
 ## What's the main goal?
 
-By the end of this module, you'll understand how to use Visual Studio's debugging tools to analyze and fix issues in your application code.
+By the end of this module, you understand how to use Visual Studio's debugging tools to analyze and fix issues in your application code.

learn-pr/language/dotnet-debug-visual-studio/includes/2-debugger.md

@@ -2,31 +2,29 @@ During your journey as a developer, there's always *that* moment when you end up
 
 > Why isn't my code working?
 
-Asking this question is a normal part of any developer's day. The trick is to get comfortable with finding and fixing your bugs with a minimum of time and frustration. When there's a bug in your program, everyone usually has their own way of dealing with this problem.
+Asking this question is a normal part of any developer's day. The trick is to get comfortable with finding and fixing your bugs with a minimum of time and frustration. When there's a bug in your program, do you deal with it in one of these ways?
 
-You probably already have tried one or more of these debugging approaches yourself:
-
-- Try running your program again because it *should* work.
+- Run the program again because it *should* work.
 - Explain your issue to a rubber duck.
-- Read through your code again to find out the issue.
+- Read through your code again to find the issue.
 - Take a walk outside.
 - Spam a few `Console.WriteLine("here")` messages in your code.
 
-You might have various degrees of success with these methods. The one approach that's commonly regarded as being more often successful is using a debugger. But what's a debugger exactly?
+You might have various degrees of success with these methods, but one approach is commonly regarded as being the most successful. Using a debugger. But what exactly is a debugger?
 
-A debugger is a software tool you can use to observe and control the execution flow of your program with an analytical approach. Its design goal is to help find the root cause of a bug and help you resolve it. It works by either hosting your program in its own execution process or running as a separate process that's attached to your running program, like .NET.
+A debugger is a software tool you can use to observe and control the execution flow of your program with an analytical approach. Its design goal is to help you find the root cause of a bug and help you resolve it. It works by hosting your program in its own execution process. Or, by running as a separate process attached to your program, like .NET.
 
-Debuggers come in different flavors. Some work directly from the command line while others come with a graphical user interface. In this module, we'll use Visual Studio's integrated graphical debugger.
+Debuggers come in different flavors. Some work directly from the command line while others come with a graphical user interface. In this module, we use Visual Studio's integrated graphical debugger.
 
 ## Why use a debugger?
 
-If you're not running your code through a debugger, that means you're probably *guessing* what's happening in your program. The primary benefit of using a debugger is that you can *watch* your program running. You can follow your program execution one line of code at a time. In this way, you avoid the chance of guessing wrong.
+If you're not running your code through a debugger, it means you're probably *guessing* what's happening in your program. The primary benefit of using a debugger is that you can *watch* your program running. You can follow your program execution one line of code at a time. In this way, you avoid the chance of guessing wrong.
 
 Every debugger has its own set of features. The two most important ones that come with almost all of them are:
 
-- *Controlling your program execution*. You can pause your program and run it step by step, which allows you to see which code is executed and how it affects your program's state.
+- *Controlling your program execution*. You can pause your program and run it step by step, which allows you to see which code is executing and how it affects your program's state.
 - *Observing of your program's state*. For example, you can look at the value of your variables and function parameters at any point during your code execution.
 
-Mastering debugger usage is an important skill for a developer that's often overlooked. It makes you more efficient at hunting bugs in your code and can help you quickly understand how a program works.
+Using a debugger effectively is an important but overlooked skill for a developer. It makes you more efficient at hunting bugs in your code and can help you quickly understand how a program works.
 
 Let's discover that in the next unit.

learn-pr/language/dotnet-debug-visual-studio/includes/3-analyze-your-program-state.md

@@ -2,9 +2,9 @@ In the previous unit, you learned that a debugger helps you control your program
 
 Let's start by learning how to use the Visual Studio debugger with .NET.
 
-## Getting Started with the Visual Studio Debugger
+## Getting started with the Visual Studio Debugger
 
-Launch the application with the debugger attached using the **Start** button at the top of Visual Studio, which now includes our project name. Once the app is running, more debugging tools and features become available.
+Use the **Start** button in the Visual Studio command bar to launch the application with the debugger attached. Notice that the command bar now includes our project name. Once the app is running, more debugging tools and features become available.
 
 :::image source="../media/visual-studio-debugging-controls.png" alt-text="Screenshot of Visual Studio debugging controls.":::