Merge pull request #13248 from anandmeg/uuf-201280

Add info adding code file name for each code block

Author: prmerger-automator[bot]

docs/get-started/csharp/tutorial-windows-forms-match-game-icons.md

@@ -77,7 +77,7 @@ To learn more about lists, see <xref:System.Collections.Generic.List%601>. To se
 Each time you run the program, it assigns the icons randomly to the Label controls on your form by using an `AssignIconsToSquares()` method.
 This code uses the keyword `foreach` in C# or `For Each` in Visual Basic.
 
-1. Add the `AssignIconsToSquares()` method.
+1. Add the `AssignIconsToSquares()` method to `Form1.cs` or `Form1.vb`.
 
    ### [C#](#tab/csharp)
    :::code language="csharp" source="../../snippets/csharp/VS_Snippets_VBCSharp/vbexpresstutorial4step2_3_4/cs/form1.cs" id="Snippet2":::
@@ -108,13 +108,13 @@ This code uses the keyword `foreach` in C# or `For Each` in Visual Basic.
      The line is commented out here so you can verify the rest of the code before proceeding.
    - The last line in the `if` statement removes the icon that has been added to the form from the list.
 
-1. Add a call to the `AssignIconsToSquares()` method to the **Form1** *constructor*.
+1. Add a call to the `AssignIconsToSquares()` method to the **Form1** *constructor* in `Form1.cs`.
    This method fills the game board with icons.
    Constructors are called when you create an object.
 
    :::code language="csharp" source="../../snippets/csharp/VS_Snippets_VBCSharp/vbexpresstutorial4step2_3_4/cs/form1.cs" id="Snippet13":::
 
-   For Visual Basic, add the `AssignIconsToSquares()` method call to the `Form1_Load` method.
+   For Visual Basic, add the `AssignIconsToSquares()` method call to the `Form1_Load` method in `Form1.vb`.
 
    ```vb
    Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load
@@ -135,7 +135,7 @@ This code uses the keyword `foreach` in C# or `For Each` in Visual Basic.
 
    The icons are visible now because you haven't hidden them. To hide them from the player, you can set each label's **ForeColor** property to the same color as its **BackColor** property.
 
-1. Stop the program. Remove the comment marks for the commented line of code inside the loop.
+1. Stop the program. Remove the comment marks for the commented line of code inside the loop in the `AssignIconsToSquares()` method.
 
    ### [C#](#tab/csharp)
    :::code language="csharp" source="../../snippets/csharp/VS_Snippets_VBCSharp/vbexpresstutorial4step2_3_4/cs/form1.cs" id="Snippet15":::
@@ -168,7 +168,7 @@ To get your game to work this way, add a <xref:System.Windows.Forms.Control.Clic
 
      ![Screenshot shows the Properties window showing Click event.](../media/tutorial-windows-forms-match-game-icons/click-event.png)
 
-1. Select the **Enter** key. The IDE adds a `Click` event handler called **label1 _Click()** to the code.
+1. Select the **Enter** key. The IDE adds a `Click` event handler called **label1 _Click()** to the code in **Form1.cs** or **Form1.vb**.
    Because you selected all the labels, the handler is hooked to each of the labels.
 
 1. Fill in the rest of the code.

docs/get-started/csharp/tutorial-windows-forms-match-game-labels.md

@@ -9,7 +9,7 @@ ms.author: meghaanand
 manager: mijacobs
 ms.subservice: general-ide
 ms.topic: tutorial
-ms.date: 03/16/2023
+ms.date: 10/18/2024
 ms.custom: vs-acquisition
 ---
 # Tutorial: Add reference variables and a timer control to your matching game WinForms app
@@ -38,19 +38,21 @@ Complete those tutorials first.
 In this section, you'll add two *reference variables* to your code.
 They keep track of, or refer to Label objects.
 
-1. Add label references to your form by using the following code.
+1. Add label references to your form by using the following code in `Form1.cs` or `Form1.vb`.
 
    ### [C#](#tab/csharp)
    :::code language="csharp" source="../../snippets/csharp/VS_Snippets_VBCSharp/vbexpresstutorial4step5/cs/form1.cs" id="Snippet5":::
 
    ### [VB](#tab/vb)
    :::code language="vb" source="../../snippets/visualbasic/VS_Snippets_VBCSharp/vbexpresstutorial4step5/vb/form1.vb" id="Snippet5":::
    ---
+   
+   If you're using C#, put the code after the opening curly brace and just after the class declaration (`public partial class Form1 : Form`). If you're using Visual Basic, put the code right after the class declaration (`Public Class Form1`).
 
    These statements don't cause Label controls to appear on the form because there's no `new` keyword.
    When the program starts, both `firstClicked` and `secondClicked` are set to `null` for C# or `Nothing` for Visual Basic.
 
-2. Modify your <xref:System.Windows.Forms.Control.Click> event handler to use the new `firstClicked` reference variable.
+2. Modify your <xref:System.Windows.Forms.Control.Click> event handler in `Form1.cs` or `Form1.vb` to use the new `firstClicked` reference variable.
    Remove the last statement in the `label1_Click()` event handler method (`clickedLabel.ForeColor = Color.Black;`) and replace it with the `if` statement as follows.
 
    ### [C#](#tab/csharp)
@@ -94,7 +96,7 @@ If the icons don't match, it hides the two icons again after a short period of t
    Your program calls the <xref:System.Windows.Forms.Timer.Start> method to start the timer after the player chooses the second label.
 
 4. Choose the timer control icon and then press **Enter**, or double-click the timer.
-   The IDE adds an empty Tick event handler.
+   The IDE adds an empty Tick event handler to `Form1.cs` or `Form1.vb`.
    Replace the code with the following code.
 
    ### [C#](#tab/csharp)
@@ -109,7 +111,7 @@ If the icons don't match, it hides the two icons again after a short period of t
    - It uses two reference variables, `firstClicked` and `secondClicked`, to make the icons of the two labels that the player chose invisible again.
    - It resets the `firstClicked` and `secondClicked` reference variables to `null` in C# and `Nothing` in Visual Basic.
 
-5. Go to the code editor and add code to the top and bottom of the `label1_Click()` event handler method. 
+5. Go to the code editor and add code to the top and bottom of the `label1_Click()` event handler method in `Form1.cs` or `Form1.vb`. 
    This code will check if the timer is enabled, set the `secondClicked` reference variable, and start the timer.
    The `label1_Click()` event handler method now looks as follows: