Update environment docs to recommend dotnet 9 as of 3.8.4.1

Author: SimonDarksideJ

articles/getting_started/1_setting_up_your_os_for_development_arch.md

@@ -6,16 +6,19 @@ description: This section provides a step-by-step guide for setting up your deve
 > [!TIP]
 > Arch Linux is a rolling release distribution. This guide was tested in October 2025 with kernel `version 6.15.9-arch1-1`.
 
-To develop with MonoGame in C#, you will need to install the .NET SDK. As of MonoGame 3.8.2 the minimum supported version is .NET 8.
+To develop with MonoGame in C#, you will need to install the .NET 9 SDK. As of MonoGame 3.8.4.1 the recommended version is .NET 9.
 
-## Install .NET 8 SDK
+> [!TIP]
+> You can still continue to use .NET 8 if you wish, you will just need to downgrade your client project .NET version in the `csproj` setup for your project (if using the default templates)
+
+## Install .NET 9 SDK
 
 1. Open a new **Terminal** window.
-2. Enter the following command in the terminal to install the latest .NET 8 SDK:
+2. Enter the following command in the terminal to install the latest .NET 9 SDK:
 
     ```sh
     sudo pacman -Syu
-    sudo pacman -S dotnet-sdk-8.0
+    sudo pacman -S dotnet-sdk-9.0
     ```
 
 ## Install additional workloads
@@ -78,10 +81,10 @@ MonoGame provides a setup script that can be executed to setup the Wine environm
     > sudo ln -s /usr/bin/wine /usr/local/bin/wine64
     > ```
 
-3. Now that the prerequisites are installed, download the [mgfxc_wine_setup.sh](https://monogame.net/downloads/net8_mgfxc_wine_setup.sh) script and execute it by entering the following command in the terminal:
+3. Now that the prerequisites are installed, download the [mgfxc_wine_setup.sh](https://monogame.net/downloads/net9_mgfxc_wine_setup.sh) script and execute it by entering the following command in the terminal:
 
     ```sh
-    wget -qO- https://monogame.net/downloads/net8_mgfxc_wine_setup.sh | bash
+    wget -qO- https://monogame.net/downloads/net9_mgfxc_wine_setup.sh | bash
     ```
 
     > [!TIP]

articles/getting_started/1_setting_up_your_os_for_development_macos.md

@@ -3,15 +3,18 @@ title: Setting up your OS for development on MacOS
 description: This section provides a step-by-step guide for setting up your development environment on Mac.
 ---
 
-To develop with MonoGame in C#, you will need to install the .NET SDK. As of MonoGame 3.8.2 the minimum supported version is .NET 8.
+To develop with MonoGame in C#, you will need to install the .NET SDK. As of MonoGame 3.8.4.1 the recommended version is .NET 9.
 
-## Install .NET 8 SDK
+> [!TIP]
+> You can still continue to use .NET 8 if you wish, you will just need to downgrade your client project .NET version in the `csproj` setup for your project (if using the default templates)
 
-1. Navigate to [https://dotnet.microsoft.com/en-us/download/dotnet/8.0](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
+## Install .NET 9 SDK
+
+1. Navigate to [https://dotnet.microsoft.com/en-us/download/dotnet/9.0](https://dotnet.microsoft.com/en-us/download/dotnet/9.0)
 2. Download the `.NET SDK` Installer for your current platform of `macOS`
 3. Once the **.pkg** file finishes downloading, run it and follow the prompts to install the .NET SDK
 
-    ![Download .NET For Windows](./images/1_setting_up_your_development_environment/dotnet_8_download_page.png)
+    ![Download .NET For Windows](./images/1_setting_up_your_development_environment/dotnet_9_download_page.png)
 
 ## Install additional workloads
 
@@ -52,7 +55,7 @@ If you intend to also work with platforms such as `Android` or `iOS`, you will n
 
  For the time being, MonoGame requires that you install the x64 version of the .NET runtime if you are running on an Apple Silicon mac in order to be able to build content. It is also required that [Rosetta](https://support.apple.com/en-us/HT211861) is enabled. 
 
- 1. Navigate to [https://dotnet.microsoft.com/en-us/download/dotnet/8.0](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
+ 1. Navigate to [https://dotnet.microsoft.com/en-us/download/dotnet/9.0](https://dotnet.microsoft.com/en-us/download/dotnet/9.0)
  1. Download the .NET Runtime Installer for macOS x64
  1. Once the **.pkg** file finishes downloading, run it and follow the prompts to install the .NET Runtime
 
@@ -72,7 +75,7 @@ MonoGame provides a setup script that can be executed to setup the Wine environm
 1. Now that the prerequisites are installed, download the [mgfxc_wine_setup.sh](https://monogame.net/downloads/net9_mgfxc_wine_setup.sh) script and execute it by entering the following command in the terminal:
 
     ```sh
-    wget -qO- https://monogame.net/downloads/net8_mgfxc_wine_setup.sh | bash
+    wget -qO- https://monogame.net/downloads/net9_mgfxc_wine_setup.sh | bash
     ```
 
 This will create new directory called `.winemonogame` in your home directory.  If you ever wish to undo the setup this script performed, just simply delete that directory.

articles/getting_started/1_setting_up_your_os_for_development_ubuntu.md

@@ -6,15 +6,15 @@ description: This section provides a step-by-step guide for setting up your deve
 > [!TIP]
 > The minimum version of Ubuntu that is supported by MonoGame is `20.04`.
 
-To develop with MonoGame in C#, you will need to install the .NET SDK. As of MonoGame 3.8.2 the minimum supported version is .NET 8.
+To develop with MonoGame in C#, you will need to install the .NET SDK. As of MonoGame 3.8.4.1 the minimum supported version is .NET 9.
 
-## Install .NET 8 SDK
+## Install .NET 9 SDK
 
 1. Open a new **Terminal** window.
-2. Enter the following command in the terminal to install the latest .NET 8 SDK:
+2. Enter the following command in the terminal to install the latest .NET 9 SDK:
 
     ```sh
-    sudo apt-get update && sudo apt-get install -y dotnet-sdk-8.0
+    sudo apt-get update && sudo apt-get install -y dotnet-sdk-9.0
     ```
 
 ## Install additional workloads
@@ -75,10 +75,10 @@ MonoGame provides a setup script that can be executed to setup the Wine environm
     >
     > Then try installing the packages again.
 
-3. Now that the prerequisites are installed, download the [mgfxc_wine_setup.sh](https://monogame.net/downloads/net8_mgfxc_wine_setup.sh) script and execute it by entering the following command in the terminal:
+3. Now that the prerequisites are installed, download the [mgfxc_wine_setup.sh](https://monogame.net/downloads/net9_mgfxc_wine_setup.sh) script and execute it by entering the following command in the terminal:
 
     ```sh
-    wget -qO- https://monogame.net/downloads/net8_mgfxc_wine_setup.sh | bash
+    wget -qO- https://monogame.net/downloads/net9_mgfxc_wine_setup.sh | bash
     ```
 
 This will create new directory called `.winemonogame` in your home directory.  If you ever wish to undo the setup this script performed, just simply delete that directory.

articles/getting_started/1_setting_up_your_os_for_development_windows.md

@@ -3,21 +3,21 @@ title: Setting up your OS for development on Windows
 description: This section provides a step-by-step guide for setting up your development environment on Windows.
 ---
 
-To develop with MonoGame in C#, you must install the .NET SDK. As of MonoGame 3.8.2 the minimum supported version is .NET 8.
+To develop with MonoGame in C#, you must install the .NET SDK. As of MonoGame 3.8.4.1 the minimum supported version is .NET 9.
 
 > [!IMPORTANT]
 > If your chosen IDE for development is [Visual Studio](https://visualstudio.microsoft.com/) then you can skip this step as .NET 8 is included with the Visual Studio Installer.
 
-## Install .NET 8 SDK
+## Install .NET 9 SDK
 
-You can follow the instructions below based on your operating system to install the .NET 8.0 SDK
+You can follow the instructions below based on your operating system to install the .NET 9.0 SDK
 
-1. Navigate to [https://dotnet.microsoft.com/en-us/download/dotnet/8.0](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
+1. Navigate to [https://dotnet.microsoft.com/en-us/download/dotnet/9.0](https://dotnet.microsoft.com/en-us/download/dotnet/9.0)
 
-    ![Download .NET For Windows](./images/1_setting_up_your_development_environment/dotnet_8_download_page.png)
+    ![Download .NET For Windows](./images/1_setting_up_your_development_environment/dotnet_9_download_page.png)
 
-2. Click the **.NET SDK x64** download button to download.  This will take you to the download page where the **dotnet-sdk-8.x.yyy-win-x64.exe** will download.
-3. When the download completes, run the **dotnet-sdk-8.x.yyy-win-x64.exe** installer and complete the steps to install .NET on your machine.
+2. Click the **.NET SDK x64** download button to download.  This will take you to the download page where the **dotnet-sdk-9.x.yyy-win-x64.exe** will download.
+3. When the download completes, run the **dotnet-sdk-9.x.yyy-win-x64.exe** installer and complete the steps to install .NET on your machine.
 4. When the installation completes, open a new **Command Prompt** window and run the command `dotnet` to verify the installation was successful.
 
     ![Verify Installation](./images/1_setting_up_your_development_environment/vscode/windows/verify-install.png)