Merge branch 'main' into MusicAndSoundEffectsLabelAddedToSliders

Author: jordanlhunt

LICENSE

@@ -1,5 +1,5 @@
 Microsoft Public License (Ms-PL)
-MonoGame - Copyright © 2009-2025 MonoGame Foundation, Inc
+MonoGame - Copyright © 2009-2026 MonoGame Foundation, Inc
 
 All rights reserved.
 

articles/getting_started/1_setting_up_your_os_for_development_arch.md

@@ -6,7 +6,7 @@ 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 9 SDK. As of MonoGame 3.8.4.1 the recommended version is .NET 9.
+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, .NET 10 is also supported.
 
 > [!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)

articles/getting_started/1_setting_up_your_os_for_development_macos.md

@@ -3,7 +3,7 @@ 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.4.1 the recommended version is .NET 9.
+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, .NET 10 is also supported.
 
 > [!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)

articles/getting_started/1_setting_up_your_os_for_development_windows.md

@@ -3,7 +3,7 @@ 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.4.1 the minimum supported version is .NET 9.
+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, .NET 10 is also supported.
 
 > [!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.

articles/getting_started/index.md

@@ -21,7 +21,7 @@ MonoGame supports the following platforms by default:
 - Nintendo Switch*
 
 > [!IMPORTANT]
-> Platforms marked with a *"*"* require developer access from their host vendor platforms.
+> Platforms marked with a *"\*"* require developer access from their host vendor platforms.
 
 See [Supported Platforms](./platforms.md) for more information.
 

articles/getting_to_know/howto/content_pipeline/HowTo_ExtendFontProcessor.md

@@ -6,6 +6,11 @@ requireMSLicense: true
 
 In a font description (.spritefont) file, the `<CharacterRegions>` area can be used to add additional characters to a font description. This enables you to use a [SpriteFont](xref:Microsoft.Xna.Framework.Graphics.SpriteFont) to render an additional range of characters.
 
+> [!IMPORTANT]
+> For the MGCB system (MGCB Editor), all custom pipeline extension libraries **MUST** target `.NET 8` or lower, this is due to the Editor and Command-line project only supporting `.NET 8` currently.  If you get errors with an Extension at build time, the `.NET` version of the library is the most likely cause.
+>
+> This will be resolved with the introduction of the new [Content Builder Project](/articles/getting_started/content_pipeline/content_builder_project.md) solution, which removes such limitations.
+
 For some languages, this approach is not ideal. For example, Chinese and Japanese both have many thousands of characters. Adding the full range of characters to `<CharacterRegions>` dramatically increases the size of the font asset and the time required to build the font asset. A better solution adds individual characters whenever the specific characters are needed. You can create a custom content processor to implement this solution.
 
 In this example, a file called _messages.txt_ contains all the text rendered by the game. The custom processor adds all the characters contained in the text in this file to a [FontDescription](xref:Microsoft.Xna.Framework.Content.Pipeline.Graphics.FontDescription). Then it processes the object in the standard way using the base [FontDescriptionProcessor](xref:Microsoft.Xna.Framework.Content.Pipeline.Processors.FontDescriptionProcessor) functionality. All the characters in messages.txt will then be available to the [SpriteFont](xref:Microsoft.Xna.Framework.Graphics.SpriteFont) object at run time.

articles/getting_to_know/howto/content_pipeline/HowTo_Extend_Processor.md

@@ -6,6 +6,11 @@ requireMSLicense: true
 
 MonoGame lets you modify or extend the behavior of any standard Content Pipeline processor that ships with the product. See [Standard Content Importers and Content Processors](../../whatis/content_pipeline/CP_StdImpsProcs.md) for a description of standard processors.
 
+> [!IMPORTANT]
+> For the MGCB system (MGCB Editor), all custom pipeline extension libraries **MUST** target `.NET 8` or lower, this is due to the Editor and Command-line project only supporting `.NET 8` currently.  If you get errors with an Extension at build time, the `.NET` version of the library is the most likely cause.
+>
+> This will be resolved with the introduction of the new [Content Builder Project](/articles/getting_started/content_pipeline/content_builder_project.md) solution, which removes such limitations.
+
 Because there are so many asset variants supported by different digital content creation (DCC) tools, it is often useful to be able to modify how one of the standard processors operates. The following examples illustrate some of the kinds of things you might want to do.
 
 > [!TIP]

articles/getting_to_know/whatis/content_pipeline/CP_Architecture.md

@@ -40,6 +40,8 @@ The managed code objects created by the Content Processor are serialized into a
 
 The format of data in the .XNB file is tightly coupled to the MonoGame Framework. It is not designed for use by other runtime libraries.
 
+If you are intested in the format of the .XNB files you can view the [XNB specification](XNB Format.docx).
+
 ### Runtime Components
 
 Runtime components of the Content Pipeline support loading and using the transformed game asset by your MonoGame game. These components use the [MonoGame library](../monogame_class_library/index.md), which can be extended to create custom components.

articles/getting_to_know/whatis/content_pipeline/XNB Format.docx

@@ -12,20 +12,26 @@ Unlike game engines (such as Unity, Unreal or Godot), MonoGame is a *framework*.
 
 While the environment setup process is similar to the standard setup process for C# development, there are some MonoGame specific steps. These can vary slightly depending on your operating system and the *Integrated Development Environment* (IDE).
 
+## Chapter Video
+
+|<iframe style="max-width: 50%; aspect-ratio: 16 / 9; width: 100%;" src="https://www.youtube.com/embed/Otx-8ON90cc?si=3q9i4vJQGba9UA9B" title="Live Recording" frameborder="0" allow="autoplay; encrypted-media; picture-in-picture" allowfullscreen></iframe>|
+|:-:|
+|**Live Recording**|
+
 ## Installing the .NET SDK
 
 The first thing we need to do is install the .NET *Software Development Kit* (SDK). To install it, follow the instructions based on your operating system below:
 
 > [!IMPORTANT]
-> As of MonoGame 3.8.2, the minimum supported version of the .NET SDK is .NET 8.
+> As of MonoGame 3.8.4, the recommended minimum version of the .NET SDK is .NET 9, .NET 10 is also supported.
 
 ### [Windows](#tab/windows)
 
 1. Open a web browser and navigate to [https://dotnet.microsoft.com/en-us/download](https://dotnet.microsoft.com/en-us/download).
 2. Choose the version of the .NET SDK to install and click the **Download .NET SDK x64** button to start the download.
 
     > [!NOTE]
-    > The minimum supported version is .NET 8
+    > The minimum recommended version is a minimum of .NET 9, .NET 10 is also supported.
 
 3. Once the download finishes, run the installer.
 
@@ -35,7 +41,7 @@ The first thing we need to do is install the .NET *Software Development Kit* (SD
 2. Choose the version of the .NET SDK to install and click the *Download .NET SDK x64 (Intel)* button start the download of the .NET SDK Installer.
 
     > [!NOTE]
-    > The minimum supported version is .NET 8
+    > The minimum recommended version is a minimum of .NET 9, .NET 10 is also supported.
 
 3. Once the download finishes, run the installer.  
 
@@ -52,7 +58,7 @@ sudo apt-get update && sudo apt-get install -y dotnet-sdk-8.0
 ```
 
 > [!NOTE]
-> The minimum supported version is .NET 8
+> The minimum recommended version is a minimum of .NET 9, .NET 10 is also supported.
 
 ---
 
@@ -272,11 +278,12 @@ Now that your development environment is setup and ready to go, you can dive in
 2. What is the primary reason that game applications implement a *game loop* structure instead of using an event-based approach like traditional desktop applications?
 
     :::question-answer
-    Game applications implement a *game loop* structure because games need to continuously update and render, event when there is no user input.  In games, objects might be moving, animations playing, and physics calculating regardless of user interaction, requiring constant updating and rendering until the game is told to exit.
+    Game applications implement a *game loop* structure because games need to continuously update and render, even when there is no user input.  In games, objects might be moving, animations playing, and physics calculating regardless of user interaction, requiring constant updating and rendering until the game is told to exit.
     :::
 
 3. What is the color of the game window when you run a MonoGame project for the first time?
 
     :::question-answer
     Cornflower Blue
     :::
+