Merge pull request MonoGame#38 from MonoGame/feature/content_update

Migration of XNA upgraded documentation and general tidy up

Author: SimonDarksideJ

articles/getting_started/1_setting_up_your_development_environment_unix.md

@@ -1,15 +1,11 @@
 ---
 title: Setting up your development environment for macOS and Linux
-description: A step-by-step guide for setting up your development environment on macOS and Linux.
+description: This section provides a step-by-step guide for setting up your development environment on macOS and Linux.
 ---
 
-# Setting up your development environment for macOS and Linux
-
-This section provides a step-by-step guide for setting up your development environment on macOS and Linux.
-
 The only development environment that MonoGame officially supports on Linux is [Visual Studio Code](https://code.visualstudio.com/).
 
-## Install .NET 6 SDK
+## Install .NET 8 SDK
 
 - .NET SDK at: [https://dotnet.microsoft.com/en-us/download](https://dotnet.microsoft.com/en-us/download)
 - If you are intending to target mobile platforms, make sure that you have the corresponding workload installed
@@ -34,6 +30,7 @@ code --install-extension ms-dotnettools.csharp
 ```
 
 If you want, you can also install the C# Dev Kit extensions, which are not open source:
+
 ```sh
 code --install-extension ms-dotnettools.csdevkit
 code --install-extension ms-dotnettools.dotnet-maui

articles/getting_started/1_setting_up_your_development_environment_vscode.md

@@ -1,12 +1,8 @@
 ---
 title: Setting up your development environment for Windows
-description: A step-by-step guide for setting up your development environment on Windows.
+description: This section provides a step-by-step guide for setting up your development environment on Windows.
 ---
 
-# Setting up your development environment for Windows
-
-This section provides a step-by-step guide for setting up your development environment on Windows.
-
 MonoGame can work with most .NET compatible tools, but we recommend [Visual Studio 2022](https://visualstudio.microsoft.com/vs/)
 
 Alternatively, you can use [JetBrains Rider](https://www.jetbrains.com/rider/) or [Visual Studio Code](https://code.visualstudio.com/).
@@ -37,31 +33,31 @@ To create new MonoGame projects from within Visual Studio 2022, you will need to
 1. Launch Visual Studio 2022
 2. Select **Continue without code**.  This will launch Visual Studio without any project or solution opened.
 
-![Visual Studio Launcher Continue Without Code](images/1_continue_without_code.png)
+    ![Visual Studio Launcher Continue Without Code](images/1_continue_without_code.png)
 
 3. Click "*Extensions -> Manage Extensions* in the Visual Studio 2022 menu bar.  This will open the Manage Extensions dialog window.
 
-![Extensions -> Manage Extensions Menu Selection](images/1_visual_studio_extension_menu.png)
+    ![Extensions -> Manage Extensions Menu Selection](images/1_visual_studio_extension_menu.png)
 
 4. Use the search box in the top-right corner of the Manage Extensions dialog window to search for **MonoGame**, then click the **MonoGame Framework C# project templates** extension as shown below and download it to install it.
 
-![Visual Studio Extension Manager](images/1_visual_studio_extension_manager.png)
+    ![Visual Studio Extension Manager](images/1_visual_studio_extension_manager.png)
 
 5. After it is downloaded, an alert will appear at the bottom of the Manage Extensions window that states "Your changes will be scheduled.  The modifications will begin when all Microsoft Visual Studio windows are closed."  Click the **Close** button, then close Visual Studio 2022.
 
 6. After closing Visual Studio 2022, a VSIX Installer window will open confirming that you want to install the **MonoGame Framework C# project templates** extension.  Click the **Modify** button to accept the install.
 
-![VSIX Installer Window](images/1_vsix_installer_window.png)
+    ![VSIX Installer Window](images/1_vsix_installer_window.png)
 
 You now have the MonoGame templates installed and are ready to create new projects.
 
 **Next up:** [Creating a new project](2_creating_a_new_project_vs.md)
 
 ## [Alternative] Install the .NET 6 SDK (compatible with JetBrains Rider and Visual Studio Code)
 
-If you prefer to use JetBrains Rider or Visual Studio Code, and after installing either of them, you will also need to [install the .NET 6 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/6.0).
+If you prefer to use JetBrains Rider or Visual Studio Code, and after installing either of them, you will also need to [install the .NET 8 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/8.0).
 
-Once the .NET 6 SDK is installed, you can open a Command Prompt and install the MonoGame templates by typing the following command:
+Once the .NET 8 SDK is installed, you can open a Command Prompt and install the MonoGame templates by typing the following command:
 
 ```sh
 dotnet new --install MonoGame.Templates.CSharp

articles/getting_started/1_setting_up_your_development_environment_windows.md

@@ -1,14 +1,14 @@
 ---
-title: Creating a new project
+title: .NET CLI (JetBrains Rider or Visual Studio Code)
 description: A step-by-step guide for creating a new project using JetBrains Rider or Visual Studio Code.
 ---
 
-# .NET CLI (JetBrains Rider or Visual Studio Code)
-
 This guide will walk you through building a starter game with MonoGame using only the command line/terminal on your operating system and a lightweight coding tool of your choice (such as [Visual Studio Code](https://code.visualstudio.com/) or [JetBrains Rider](https://www.jetbrains.com/rider/)).
 
-> It is assumed that you have already properly installed the .NET 6 SDK and MonoGame.
+> [!NOTE]
+> It is assumed that you have already properly installed the .NET 8 SDK and MonoGame.
 
+> [!IMPORTANT]
 > Be aware that for iOS/iPadOS and Android, development might be limited when using the .NET CLI. Many of the development features for those targets are exclusive to Visual Studio 2022.
 
 ## Create a MonoGame Project
@@ -23,13 +23,13 @@ You can now create new MonoGame projects. To do that:
 
 For example:
 
-```
+```cli
 dotnet new mgdesktopgl -o MyGame
 ```
 
 > To know which platform identifier (short name) to use for your project, please refer to [Target Platforms](./platforms.md), or type the following command into the command prompt to list the installed templates and their corresponding short names:
-> 
-> ```
+>
+> ```cli
 > dotnet new -l
 > ```
 

articles/getting_started/2_creating_a_new_project_netcore.md

@@ -1,12 +1,11 @@
 ---
-title: Creating a new project
+title: Creating a Project with Visual Studio 2022
 description: A step-by-step guide for creating a new project using Visual Studio
 ---
 
-# Creating a Project with Visual Studio 2022
-
 This guide will walk you through building a starter game with MonoGame using Windows and Visual Studio 2022. 
 
+> [!NOTE]
 > It is assumed that you have already properly installed Visual Studio 2022 and MonoGame.
 
 Start Visual Studio 2022 and select **New Project...** in the upper left corner.

articles/getting_started/2_creating_a_new_project_vs.md

@@ -1,12 +1,9 @@
 ---
 title: Understanding the Code
-description: A look at the code that is generated after creating a new project.
+description: This tutorial will go over the code that is generated when you start a blank project.
 ---
 
-# Understanding the Code
-
-This tutorial will go over the code that is generated when you start a blank project.
-
+> [!NOTE]
 > For help with creating a project, please look at the Creating a New Project section of the [Getting Started guide](index.md).
 
 Within the **Game.cs** class file, which is the core of any MonoGame project, you will find several critical sections necessary for your game to run:

articles/getting_started/3_understanding_the_code.md

@@ -1,12 +1,9 @@
 ---
 title: Adding Content
-description: Learn how to add content such as images or sounds to your game.
+description: This tutorial will go over adding content such as images or sounds to your game.
 ---
 
-# Adding Content
-
-This tutorial will go over adding content such as images or sounds to your game.
-
+> [!NOTE]
 > For help with creating a project, please look at the [Creating a New Project](index.md) section of the Getting Started guide.
 
 ## MonoGame Content Builder Tool (MGCB Editor)

articles/getting_started/4_adding_content.md

@@ -1,11 +1,10 @@
 ---
 title: Adding Basic Code
-description: Learn how to add basic logic to your game.
+description: This tutorial will go over adding basic logic to your game
 ---
 
-# Adding Basic Code
-
-This tutorial will go over adding basic logic to your game, continuing from where [Adding Content](4_adding_content.md) left off.
+> [!NOTE]
+> this tutorial continues from where [4. Adding Content](4_adding_content.md) left off.
 
 ---
 
@@ -133,14 +132,14 @@ Find the **Update** method in the Game1.cs class file and add:
 if(Joystick.LastConnectedIndex == 0)
 {
     JoystickState jstate = Joystick.GetState(PlayerIndex.One);
-	
+
     float updatedBallSpeed = ballSpeed * (float)gameTime.ElapsedGameTime.TotalSeconds;
-	
+
     if (jstate.Axes[1] < 0)
     {
         ballPosition.Y -= updatedBallSpeed;
     }
-	else if (jstate.Axes[1] > 0)
+    else if (jstate.Axes[1] > 0)
     {
         ballPosition.Y += updatedBallSpeed;
     }

articles/getting_started/5_adding_basic_code.md

@@ -1,12 +1,8 @@
 ---
 title: Getting Started
-description: Get started creating games with MonoGame.
+description: This section walks you through the basics of MonoGame, and helps you to create your first game.
 ---
 
-# Getting Started
-
-This section walks you through the basics of MonoGame, and helps you to create your first game.
-
 First, select the operating system and toolset you will be working with to create your first MonoGame project, then continue reading to understand the basic layout of a MonoGame project.
 
 By the end of this tutorial set, you will have a working project to build for your target platform and will be ready to tackle your next steps.

articles/getting_started/index.md

@@ -3,10 +3,6 @@ title: Package games for distribution
 description: How to package your game for distribution.
 ---
 
-# Package games for distribution
-
-Once your game is ready to be published, it is recommended that you package it properly for consumption by players.
-
 ## Desktop games
 
 To publish desktop games, it is recommended that you build your project as a [self-contained](https://docs.microsoft.com/en-us/dotnet/core/deploying/#publish-self-contained) .NET application. As such, your game will require absolutely no external dependencies and should run out-of-the-box as-is.
@@ -35,14 +31,14 @@ We recommend using the .tar.gz archiving format to preserve the execution permis
 
 From the .NET CLI:
 
-```
+```cli
 dotnet publish -c Release -r osx-x64 /p:PublishReadyToRun=false /p:TieredCompilation=false --self-contained
 dotnet publish -c Release -r osx-arm64 /p:PublishReadyToRun=false /p:TieredCompilation=false --self-contained
 ```
 
 We recommend that you distribute your game as an [application bundle](https://developer.apple.com/library/archive/documentation/CoreFoundation/Conceptual/CFBundles/BundleTypes/BundleTypes.html). Application bundles are directories with the following file structure:
 
-```
+```text
 YourGame.app                    (this is your root folder)
     - Contents
         - Resources
@@ -56,6 +52,7 @@ YourGame.app                    (this is your root folder)
 ```
 
 The contents of the entry point script:
+
 ```sh
 #!/bin/bash
 
@@ -67,7 +64,7 @@ else
 fi
 ```
 
-The Info.plist file is a standard macOS file containing metadata about your game. Here's an example file with required and recommended values set:
+The `Info.plist` file is a standard macOS file containing metadata about your game. Here is an example file with required and recommended values set:
 
 ```xml
 <?xml version="1.0" encoding="UTF-8"?>