Merge branch 'main' into feature/MobileDeployment

Author: SimonDarksideJ

.github/workflows/main.yml

@@ -34,6 +34,11 @@ jobs:
         with:
           dotnet-version: '8.0.x'
 
+      - name: Setup Premake5
+        uses: abel0b/setup-premake@v2.4
+        with:
+          version: "5.0.0-beta2"          
+
       - name: Restore dotnet tools
         run: dotnet tool restore
 

.github/workflows/pullrequest.yml

@@ -34,6 +34,11 @@ jobs:
         with:
           dotnet-version: '8.0.x'
 
+      - name: Setup Premake5
+        uses: abel0b/setup-premake@v2.4
+        with:
+          version: "5.0.0-beta2"    
+
       - name: Restore dotnet tools
         run: dotnet tool restore
 

articles/console_access.md

@@ -5,7 +5,7 @@ description: How do I get access to console versions of MonoGame?
 
 MonoGame is free to use on all platforms from the [public repository](https://github.dev/MonoGame/monogame), but the code for supporting console platforms is only accessible to authorized console developers.
 
-These platforms are provided as private code repositories that add integrations with the console vendor's APIs and platform specific documentation.
+These platforms are provided as private code repositories that add integrations with the console vendor's APIs and platform-specific documentation.
 
 ## Application process
 
@@ -23,7 +23,7 @@ The instructions below will help you gain access to each platform.
 
 ![Nintendo Switch](images/nintendo_switch.png)
 
-Your first step is to register as [Nintendo Developer](https://developer.nintendo.com/register) for Nintendo Switch.
+Your first step is to register as a [Nintendo Developer](https://developer.nintendo.com/register) for Nintendo Switch.
 
 Once you are in the program, you can go to the middleware page and fill out the [MonoGame - Nintendo Developer Authorization](https://developer.nintendo.com/group/development/getting-started/g1kr9vj6/middleware/monogame) form.
 

articles/contributing.md

@@ -19,7 +19,7 @@ Thank you for choosing to contribute to the MonoGame project! This page provides
 
 The MonoGame documentation contains two types of documents: articles and API references.
 
-Articles include manuals, guides and tutorials on how to use the MonoGame Framework to create games.
+Articles include manuals, guides, and tutorials on how to use the MonoGame Framework to create games.
 
 API references provide detailed explanation of each class and method found in the MonoGame Framework. The documentation is written in the [C# XML format](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/xmldoc/xml-documentation-comments) and is inline to the MonoGame source code. 
 
@@ -68,7 +68,7 @@ Being inline with the code allows you to easily look for critical information wi
 
 ### Focus on What Adds Value to the Consumer
 
-Limit documentation to public methods and functions unless there is a specific reason to include internal methods, while documenting internals helps with readability of the code, it provides limited use to consumers of the MonoGame Framework.
+Limit documentation to public methods and functions unless there is a specific reason to include internal methods, while documenting internals helps with the readability of the code, it provides limited use to consumers of the MonoGame Framework.
 
 ### Documentation Is Referenced Not Read
 
@@ -94,7 +94,7 @@ With a few points to call out:
 
 #### `<see>` and `<cref/>` should be used whenever an API reference is used in the documentation
 
-To ensure that API documentation is linked to whichever reference is used, `<see>` and `<cref/>` references should be used, this helps users navigate the methods, especially when looking up initializers or use of a property or method.
+To ensure that API documentation is linked to whichever reference is used, `<see>` and `<cref/>` references should be used. This helps users navigate the methods, especially when looking up initializers or use of a property or method.
 
 #### Avoid self referencing `<cref/>` unless it provides value
 
@@ -121,7 +121,7 @@ and the y component uses 6 bits.
 
 > [!NOTE]
 > If the `cref` description would cause the line to exceed the 120 recommendation, this is generally ok, so long as the rendered line does not exceed the limit.
-> THe limit however, is more of a guideline than a hard rule, so common sense should be applied to keep the limit near 120 characters.
+> The limit however, is more of a guideline than a hard rule, so common sense should be applied to keep the limit near 120 characters.
 
 #### Use the packed multi-line style with surrounding tags
 

articles/getting_started/2_choosing_your_ide_vscode.md

@@ -91,6 +91,8 @@ The .NET MAUI extension adds features for building mobile apps, including:
 - Easy target switching - Change debug/deploy targets between different mobile platforms
 - Enhanced C# Dev Kit integration - Leverages Solution Explorer, Test Explorer, and advanced language features
 
+![Install .NET MAUI DevKit Extension](../tutorials/building_2d_games/02_getting_started/images/maui-extension.png)
+
 > [!NOTE]
 > This extension is recommended if you wish to do iOS or Android development. It is required for debugging support when working on mobile games. 
 

articles/getting_started/platforms.md

@@ -101,7 +101,7 @@ Building for Android also requires the Java 11 JDK (we recommend that you use [t
 
 The iOS platform uses [Xamarin.iOS](https://docs.microsoft.com/en-us/xamarin/ios/). **OpenGL** is used for graphics, and OpenAL for audio.
 
-Building for Android requires the .NET Xamarin component to be installed. You can install it with the Visual Studio installer (if you are using Visual Studio) or with the CLI command `dotnet workload install ios` (if you are working with Rider, VS Code, or the CLI).
+Building for iOS requires the .NET Xamarin component to be installed. You can install it with the Visual Studio installer (if you are using Visual Studio) or with the CLI command `dotnet workload install ios` (if you are working with Rider, VS Code, or the CLI).
 
 The latest version of Xcode will also be required.
 

articles/getting_to_know/whatis/graphics/WhatIs_Sprite.md

@@ -17,7 +17,7 @@ Sprites are 2D bitmaps that are drawn directly to a render target without using
 
 ## Overview
 
-Sprites are positioned on the screen by coordinates. The width and height of the screen is the same as the back buffer. The x-axis represents the screen width and the y-axis represents the screen height. The y-axis is measured from the top of the screen and increases as you move **down** the screen, and the x-axis is measured from left to right. For example, when the graphics back buffer is 800×600, 0,0 is the upper left of the screen, and 800,600 is the lower right of the screen.
+Sprites are positioned on the screen by coordinates. The width and height of the screen is the same as the back buffer. The x-axis represents the screen width and the y-axis represents the screen height. The y-axis is measured from the top of the screen and increases as you move **down** the screen, and the x-axis is measured from left to right. For example, when the graphics back buffer is 800×600, the top left corner is at (0,0) and the bottom-right pixel is at (799,599).
 
 To draw a sprite, create a [SpriteBatch](xref:Microsoft.Xna.Framework.Graphics.SpriteBatch) object, initialize it by calling [Begin](/api/Microsoft.Xna.Framework.Graphics.SpriteBatch.html#Microsoft_Xna_Framework_Graphics_SpriteBatch_Begin_Microsoft_Xna_Framework_Graphics_SpriteSortMode_Microsoft_Xna_Framework_Graphics_BlendState_Microsoft_Xna_Framework_Graphics_SamplerState_Microsoft_Xna_Framework_Graphics_DepthStencilState_Microsoft_Xna_Framework_Graphics_RasterizerState_Microsoft_Xna_Framework_Graphics_Effect_System_Nullable_Microsoft_Xna_Framework_Matrix__), and then call [Draw](/api/Microsoft.Xna.Framework.Graphics.SpriteBatch.html#Microsoft_Xna_Framework_Graphics_SpriteBatch_Draw_Microsoft_Xna_Framework_Graphics_Texture2D_Microsoft_Xna_Framework_Rectangle_Microsoft_Xna_Framework_Color_) for each sprite. The bitmap data for a sprite is taken from a [Texture2D](xref:Microsoft.Xna.Framework.Graphics.Texture2D) object. The texture may contain alpha channel information to make part of the texture transparent or semi-transparent. You can tint, rotate, or scale sprites by using [Draw](/api/Microsoft.Xna.Framework.Graphics.SpriteBatch.html#Microsoft_Xna_Framework_Graphics_SpriteBatch_Draw_Microsoft_Xna_Framework_Graphics_Texture2D_Microsoft_Xna_Framework_Rectangle_Microsoft_Xna_Framework_Color_). This method also gives you the option of drawing only part of the texture on the screen. After you draw a sprite, call [End](/api/Microsoft.Xna.Framework.Graphics.SpriteBatch.html#Microsoft_Xna_Framework_Graphics_SpriteBatch_End) before calling [Present](xref:Microsoft.Xna.Framework.Graphics.GraphicsDevice.Present).
 

articles/help_and_support.md

@@ -3,14 +3,14 @@ title: Help and Support
 description: Where to get help and support when using MonoGame.
 ---
 
-There is a wealth of [community created content, blogs and tutorials](tutorials/index.md) available.
+There is a wealth of [community-created content, blogs and tutorials](tutorials/index.md) available.
 
-You can also chat to other MonoGame users via [Discord](https://discord.com/invite/monogame).
+You can also chat with other MonoGame users via [Discord](https://discord.com/invite/monogame).
 
 If you want to find an answer to a more specific problem, you can ask it on our [GitHub Discussions](https://github.com/MonoGame/MonoGame/discussions) page.
 
 ## Bugs and feature requests
 
-If you find a bug or have a feature request, [please open a new issue](https://github.com/mono/monogame/issues). Before opening any issue, please search for existing issues.
+If you find a bug or have a feature request, [please open a new issue](https://github.com/mono/monogame/issues). Before opening an issue, please check for existing ones.
 
 Please note that the issue tracker is not for requesting help.

articles/index.md

@@ -20,7 +20,7 @@ This documentation [helps you to get started](getting_started/index.md) by provi
 
 Please use the links at the top and left to navigate the documentation sections.
 
-> This documentation assume that the reader has a basic knowledge of the C# programming language.
+> This documentation assumes that the reader has a basic knowledge of the C# programming language.
 
 ## What is MonoGame exactly?
 
@@ -36,4 +36,4 @@ If you love coding and understanding how things work under the hood, MonoGame mi
 
 MonoGame is an open-source project maintained by its community. Great open source projects require high-quality documentation. This is a call for volunteers to continue to help us make the MonoGame documentation truly great. If you can create tutorials, feature guides, code snippets, reference docs, video walkthroughs, or make any improvement to the current documentation, we could use your help!
 
-Check out the [README on GitHub](https://github.com/MonoGame/MonoGame/blob/develop/README.md) or [talk with us on discord](https://discord.gg/monogame) to learn how to help!
+Check out the [README on GitHub](https://github.com/MonoGame/MonoGame/blob/develop/README.md) or [talk with us on Discord](https://discord.gg/monogame) to learn how to help!