From 325f571d77dfc6d45bb7c6d9b9077d3af4603d3a Mon Sep 17 00:00:00 2001
From: generousllama541 <98273828+generousllama541@users.noreply.github.com>
Date: Sun, 3 Nov 2024 11:03:57 -0500
Subject: [PATCH] docs: clarify xaml-mvvm tutorial

---
 .../counterapp/get-started-counter-xaml-mvvm.md               | 4 ++--
 .../counterapp/includes/include-mainpage-xaml.md              | 2 +-
 .../getting-started/counterapp/includes/include-mvvm.md       | 2 ++
 3 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/doc/articles/getting-started/counterapp/get-started-counter-xaml-mvvm.md b/doc/articles/getting-started/counterapp/get-started-counter-xaml-mvvm.md
index 24efea231a18..fa12386d2597 100644
--- a/doc/articles/getting-started/counterapp/get-started-counter-xaml-mvvm.md
+++ b/doc/articles/getting-started/counterapp/get-started-counter-xaml-mvvm.md
@@ -91,7 +91,7 @@ Also, for more information on all the template options, see [Using the Uno Platf
 
 Now that we have the **`MainViewModel`** class, we can update the **`MainPage`** to use data binding to connect the UI to the application logic.
 
-- Add a **`DataContext`** element to the **`Page`** element in the **MainPage.xaml** file.
+- Add a **`DataContext`** element to the **`Page`** element in the **MainPage.xaml** file, between the first `StackPanel` and the `Page` element.
 
     ```xml
     <Page.DataContext>
@@ -119,7 +119,7 @@ Now that we have the **`MainViewModel`** class, we can update the **`MainPage`**
              TextAlignment="Center" />
     ```
 
-- Update the **`Button`** to add a **`Command`** attribute that is bound to the **`IncrementCommand`** property of the **`MainViewModel`**.
+- Add a new **`Button`** with a  **`Command`** attribute that is bound to the **`IncrementCommand`** property of the **`MainViewModel`**.
 
     ```xml
     <Button Margin="12"
diff --git a/doc/articles/getting-started/counterapp/includes/include-mainpage-xaml.md b/doc/articles/getting-started/counterapp/includes/include-mainpage-xaml.md
index 56d2f9af98ff..f59016bdcb1e 100644
--- a/doc/articles/getting-started/counterapp/includes/include-mainpage-xaml.md
+++ b/doc/articles/getting-started/counterapp/includes/include-mainpage-xaml.md
@@ -1,4 +1,4 @@
-The layout for the **MainPage** is defined in the **MainPage.xaml** file. This file contains the XAML markup that defines the layout of the application.
+The layout for the **MainPage** is defined in the **MainPage.xaml** file. This file contains the XAML markup that defines the layout of the application. Replace your **MainPage.xaml** with the contents below:
 
 ```xml
 <Page x:Class="Counter.MainPage"
diff --git a/doc/articles/getting-started/counterapp/includes/include-mvvm.md b/doc/articles/getting-started/counterapp/includes/include-mvvm.md
index 650f7f79c082..1f5214669d08 100644
--- a/doc/articles/getting-started/counterapp/includes/include-mvvm.md
+++ b/doc/articles/getting-started/counterapp/includes/include-mvvm.md
@@ -30,6 +30,8 @@ As part of creating the application, we selected MVVM as the presentation framew
     private void Increment()
         => Count += Step;
     ```
+> [!NOTE]
+> If you see red squiggles under `Count` or `Step`, save the file to have Hot Reload apply your changes.
 
 The final code for the `MainViewModel` class should look like this: