diff --git a/1-welcome/how-to-install-vs.md b/1-welcome/how-to-install-vs.md
index def2bf5..fdc70a1 100644
--- a/1-welcome/how-to-install-vs.md
+++ b/1-welcome/how-to-install-vs.md
@@ -1,5 +1,27 @@
 # Install Visual Studio
 
+## If you're on Windows
 1. Go to the [Develop .NET applications page](https://visualstudio.microsoft.com/vs/features/net-development/) of the Visual Studio website
 1. Find the "Download Visual Studio with .NET" dropdown and select "Community 2022"
-1. 
+1. Run the exe and let Visual Studio download
+1. Wait for everything to install
+1. Sign in to Visual Studio
+1. Done ✔️
+
+## If you're on Mac
+1. Go to the [Build Web Apps using .NET Core page](https://visualstudio.microsoft.com/vs/mac/net/) of the Visual Studio website
+1. Select the VisualStudioforMacInstaller.dmg to mount the installer, then run it by double-clicking the arrow logo
+2. Select **Open**
+1. An alert will appear asking you to acknowledge the privacy and license terms. Follow the links to read them, then press **Continue** if you agree
+1. The list of available workloads is displayed. Select the .NET Core component.
+1. Press **Install**
+1. Sign in and choose your keyboard preferences
+1. Done ✔️
+
+## Want more help?
+If you want more detailed installation instructions, check out the Microsof Documentation.
+* If you're on Windows, go to [Install Visual Studio](https://docs.microsoft.com/visualstudio/install/install-visual-studio?view=vs-2022)
+* If you're on Mac, go to [Install Visual Studio for Mac](https://docs.microsoft.com/visualstudio/mac/installation?view=vsmac-2019) 
+
+Check out the [Learn to code in Visual Studio](https://visualstudio.microsoft.com/vs/getting-started/) page to learn more about the installation process, how to get started with Visual Studio, and how to make it your own with themes! 🤗
+
diff --git a/README.md b/README.md
index 7f3fbbf..f3b8e2c 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,9 @@
 
 Welcome to the Intro to Web Development with .NET GitHub repository!
 
-Here, you'll find all of the projects and challenges associated with each email in the email series. Each email will have a dedicated folder containing all the relevant information. 
+Here, you'll find all of the projects and challenges associated with each email in the email series. Each email will have a dedicated folder containing all the relevant information for that week. 
+
+We are currently in the planning stages of this series!
 
 
 ## .NET Foundation