From d8eb8eb8e221d7a3cbc660fc91dfbbc51839c603 Mon Sep 17 00:00:00 2001 From: Christopher Whitley <103014489+AristurtleDev@users.noreply.github.com> Date: Fri, 16 Aug 2024 15:53:03 -0400 Subject: [PATCH 01/13] Steps for updating MonoGame Documentation steps for updating current MonoGame versions as new ones are released more frequently. --- articles/migration/updating_versions.md | 66 +++++++++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 articles/migration/updating_versions.md diff --git a/articles/migration/updating_versions.md b/articles/migration/updating_versions.md new file mode 100644 index 00000000..fa5e03f7 --- /dev/null +++ b/articles/migration/updating_versions.md @@ -0,0 +1,66 @@ +--- +title: Updating Versions +description: A guide on updating MonoGame when a new release is pushed. +--- + +When a new release of MonoGame is pushed, developers will need to manually update their development environment and/or existing project to make use of the new version. This guide is intended to walk you through the steps of performing these updates. + +# Update dotnet Templates +Developers will need to update the MonoGame C# Templates used to create new projects. Doing this depends on if you are using Visual Studio 2022 or through the dotnet cli. + +## Visual Studio 2022 +Develoeprs using Visual Studio 2022 should be using the [MonoGame C# Project Templates](https://marketplace.visualstudio.com/items?itemName=MonoGame.MonoGame-Templates-VSExtension) extension. This provides not only the tempaltes but also the functinality to open the *MonoGame Content Builder Editor* (MGCB Editor) within Visual Studio. You can update the extension by performing the following + +1. Open Visual Studio 2022 +2. In the lanuch window, choose the *Continue without code* option at the bottom on the right. +3. From the top menu choose, *Extensions > Manage Extensions* to open the *Extension Manager* panel. +4. Click the *Updates* tab and choose *MonoGame Framework C# project templates* and update it to the latest version. + +If prompted to close Visual Studio to finish the update, do so now to continue installing the update. + +## dotent CLI +Develoeprs using the dotnet CLI with environments such as Visual Studio Code, JetBrains Rider, or other editors, can exceute the following command in a command prompt/terminal to update the templates + +```sh +dotnet new uninstall MonoGame.Templates.CSharp +dotnet new install MonoGame.Templates.CSharp +``` + +The templates must be uninstalled first before the updated tempaltes are installed; otherwise, you will see warnings about template naming conflicts between the two versions. + +Alternatively, you can perform `dotnet new update` which will update all templates installed to their most current version avaialble. However, this may affect other templates you have installed that you may not wish to update, it's an all or nothing command. + +# Update Existing Projects +Developers wishing to update their current project to use a new release version only need to update the *target framework*, *NuGet package verions*, and *dotnet tools* version. Doing this dpeends on if you are using Visual Studio 2022 or another development environment + +## Visual Studio 2022 +Open your existing project in Visual Studio 2022 and perform the following +1. Right-click on the project in the *Solution Explorer* panel and select *Manage NuGet Packages...". +2. In the NuGet Packages Manager window, click the *Updates* tab. +3. Select the MonoGame Framework packages in the list on the left, then click the *Update* button for each one on the right. + +## Manually Editing .csproj File +Alternatively, regardless of the development environment, developers can manually edit the *.csproj* file for their project to update to the newest MonoGame release. To do this +1. Open your project's *.csproj* file +2. Locate the `` elements for any MonoGame referenced packages. +3. Change the `Version=` attribute for each one to the current version of MonoGame (currently this is `3.8.2.1105`) +4. Save the *.csproj* file. + +Once these changes are made, open a command prompt or terminal at the root of the project directory and enter the following commands + +```sh +dotnet clean +dotnet restore +``` + +## Update dotent tools Manifest File +Regardless of the development environment, users will need to update the dotnet tools manifest file manually to use the newest versions. To do this: +1. Open the *.config/dotent-tools.json* manifest file located in the project root directory +2. Update the version specified for each tool to the current version of MonoGame (currently this is `3.8.2.1105`). +3. Save the changes + +Once these changes are made, open a command prompt or terminal at the root of the project directory and enter the following commands + +```sh +dotnet tool restore +``` From 80e0ca902acb33ccdccdaa46929c17a38dd21a9f Mon Sep 17 00:00:00 2001 From: Christopher Whitley <103014489+AristurtleDev@users.noreply.github.com> Date: Fri, 16 Aug 2024 15:54:13 -0400 Subject: [PATCH 02/13] Add Updating Version doc to toc --- articles/toc.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/articles/toc.yml b/articles/toc.yml index b50bc4a8..5fa23a5c 100644 --- a/articles/toc.yml +++ b/articles/toc.yml @@ -97,6 +97,8 @@ href: migration/migrate_37.md - name: Migrating from 3.8.0 href: migration/migrate_38.md + - name: Updating Versions + href: migration/updating_versions.md - name: Samples and Demos href: samples.md - name: Community Tutorials From 487f9419ab113947e238efac384acda2525a4fe8 Mon Sep 17 00:00:00 2001 From: Christopher Whitley <103014489+AristurtleDev@users.noreply.github.com> Date: Fri, 16 Aug 2024 16:44:29 -0400 Subject: [PATCH 03/13] Fix dotnet spelling --- articles/migration/updating_versions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/articles/migration/updating_versions.md b/articles/migration/updating_versions.md index fa5e03f7..d8e7b41e 100644 --- a/articles/migration/updating_versions.md +++ b/articles/migration/updating_versions.md @@ -18,7 +18,7 @@ Develoeprs using Visual Studio 2022 should be using the [MonoGame C# Project Tem If prompted to close Visual Studio to finish the update, do so now to continue installing the update. -## dotent CLI +## dotnet CLI Develoeprs using the dotnet CLI with environments such as Visual Studio Code, JetBrains Rider, or other editors, can exceute the following command in a command prompt/terminal to update the templates ```sh From 1eb116a67ab3acc5f5a61afacba206082c5c491f Mon Sep 17 00:00:00 2001 From: Christopher Whitley <103014489+AristurtleDev@users.noreply.github.com> Date: Fri, 16 Aug 2024 16:51:48 -0400 Subject: [PATCH 04/13] Make heading more clear Users not familiar with dotnet tools may not realize this section is for updating MGCB tooling --- articles/migration/updating_versions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/articles/migration/updating_versions.md b/articles/migration/updating_versions.md index d8e7b41e..004fed1e 100644 --- a/articles/migration/updating_versions.md +++ b/articles/migration/updating_versions.md @@ -53,8 +53,8 @@ dotnet clean dotnet restore ``` -## Update dotent tools Manifest File -Regardless of the development environment, users will need to update the dotnet tools manifest file manually to use the newest versions. To do this: +## Update MGCB Editor +Regardless of the development environment, users will need to update the dotnet tools manifest file manually to use the newest version of the *MonoGame Content Builder*. To do this: 1. Open the *.config/dotent-tools.json* manifest file located in the project root directory 2. Update the version specified for each tool to the current version of MonoGame (currently this is `3.8.2.1105`). 3. Save the changes From 77dab47b2dd91e41af7f239c88283ea68a5ec7cd Mon Sep 17 00:00:00 2001 From: Christopher Whitley <103014489+AristurtleDev@users.noreply.github.com> Date: Fri, 16 Aug 2024 16:55:31 -0400 Subject: [PATCH 05/13] =?UTF-8?q?Correct=20spelling=20because=20I=E2=80=99?= =?UTF-8?q?m=20terrible?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- articles/migration/updating_versions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/articles/migration/updating_versions.md b/articles/migration/updating_versions.md index 004fed1e..af318e25 100644 --- a/articles/migration/updating_versions.md +++ b/articles/migration/updating_versions.md @@ -55,7 +55,7 @@ dotnet restore ## Update MGCB Editor Regardless of the development environment, users will need to update the dotnet tools manifest file manually to use the newest version of the *MonoGame Content Builder*. To do this: -1. Open the *.config/dotent-tools.json* manifest file located in the project root directory +1. Open the *.config/dotnet-tools.json* manifest file located in the project root directory 2. Update the version specified for each tool to the current version of MonoGame (currently this is `3.8.2.1105`). 3. Save the changes From 9917d6af7cdf151f9fe0c08aa49449897a4fd832 Mon Sep 17 00:00:00 2001 From: Christopher Whitley <103014489+AristurtleDev@users.noreply.github.com> Date: Fri, 16 Aug 2024 18:08:17 -0400 Subject: [PATCH 06/13] Update header to include VSCode/rider --- articles/migration/updating_versions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/articles/migration/updating_versions.md b/articles/migration/updating_versions.md index af318e25..0491f3e3 100644 --- a/articles/migration/updating_versions.md +++ b/articles/migration/updating_versions.md @@ -18,7 +18,7 @@ Develoeprs using Visual Studio 2022 should be using the [MonoGame C# Project Tem If prompted to close Visual Studio to finish the update, do so now to continue installing the update. -## dotnet CLI +## dotnet CLI (VSCode/Rider) Develoeprs using the dotnet CLI with environments such as Visual Studio Code, JetBrains Rider, or other editors, can exceute the following command in a command prompt/terminal to update the templates ```sh From e5982b99ad3e3af046f36c2a83756bc2a18f59cf Mon Sep 17 00:00:00 2001 From: Christopher Whitley <103014489+AristurtleDev@users.noreply.github.com> Date: Fri, 16 Aug 2024 18:10:00 -0400 Subject: [PATCH 07/13] Use correct heading levels --- articles/migration/updating_versions.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/articles/migration/updating_versions.md b/articles/migration/updating_versions.md index 0491f3e3..fdab3314 100644 --- a/articles/migration/updating_versions.md +++ b/articles/migration/updating_versions.md @@ -5,10 +5,10 @@ description: A guide on updating MonoGame when a new release is pushed. When a new release of MonoGame is pushed, developers will need to manually update their development environment and/or existing project to make use of the new version. This guide is intended to walk you through the steps of performing these updates. -# Update dotnet Templates +## Update dotnet Templates Developers will need to update the MonoGame C# Templates used to create new projects. Doing this depends on if you are using Visual Studio 2022 or through the dotnet cli. -## Visual Studio 2022 +### Visual Studio 2022 Develoeprs using Visual Studio 2022 should be using the [MonoGame C# Project Templates](https://marketplace.visualstudio.com/items?itemName=MonoGame.MonoGame-Templates-VSExtension) extension. This provides not only the tempaltes but also the functinality to open the *MonoGame Content Builder Editor* (MGCB Editor) within Visual Studio. You can update the extension by performing the following 1. Open Visual Studio 2022 @@ -18,7 +18,7 @@ Develoeprs using Visual Studio 2022 should be using the [MonoGame C# Project Tem If prompted to close Visual Studio to finish the update, do so now to continue installing the update. -## dotnet CLI (VSCode/Rider) +### dotnet CLI (VSCode/Rider) Develoeprs using the dotnet CLI with environments such as Visual Studio Code, JetBrains Rider, or other editors, can exceute the following command in a command prompt/terminal to update the templates ```sh @@ -30,16 +30,16 @@ The templates must be uninstalled first before the updated tempaltes are install Alternatively, you can perform `dotnet new update` which will update all templates installed to their most current version avaialble. However, this may affect other templates you have installed that you may not wish to update, it's an all or nothing command. -# Update Existing Projects +## Update Existing Projects Developers wishing to update their current project to use a new release version only need to update the *target framework*, *NuGet package verions*, and *dotnet tools* version. Doing this dpeends on if you are using Visual Studio 2022 or another development environment -## Visual Studio 2022 +### Visual Studio 2022 Open your existing project in Visual Studio 2022 and perform the following 1. Right-click on the project in the *Solution Explorer* panel and select *Manage NuGet Packages...". 2. In the NuGet Packages Manager window, click the *Updates* tab. 3. Select the MonoGame Framework packages in the list on the left, then click the *Update* button for each one on the right. -## Manually Editing .csproj File +### Manually Editing .csproj File Alternatively, regardless of the development environment, developers can manually edit the *.csproj* file for their project to update to the newest MonoGame release. To do this 1. Open your project's *.csproj* file 2. Locate the `` elements for any MonoGame referenced packages. @@ -53,7 +53,7 @@ dotnet clean dotnet restore ``` -## Update MGCB Editor +### Update MGCB Editor Regardless of the development environment, users will need to update the dotnet tools manifest file manually to use the newest version of the *MonoGame Content Builder*. To do this: 1. Open the *.config/dotnet-tools.json* manifest file located in the project root directory 2. Update the version specified for each tool to the current version of MonoGame (currently this is `3.8.2.1105`). From 201cfd1fc2b29a66e1f11204317989cd0bdea084 Mon Sep 17 00:00:00 2001 From: Christopher Whitley <103014489+AristurtleDev@users.noreply.github.com> Date: Fri, 16 Aug 2024 18:17:05 -0400 Subject: [PATCH 08/13] Add note about existing projects --- articles/migration/updating_versions.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/articles/migration/updating_versions.md b/articles/migration/updating_versions.md index fdab3314..d75a8986 100644 --- a/articles/migration/updating_versions.md +++ b/articles/migration/updating_versions.md @@ -8,6 +8,9 @@ When a new release of MonoGame is pushed, developers will need to manually updat ## Update dotnet Templates Developers will need to update the MonoGame C# Templates used to create new projects. Doing this depends on if you are using Visual Studio 2022 or through the dotnet cli. +> [!NOTE] +> Updating the templates will not affect existing projects. if developers wish to update existing project, see the info in the [Update Existing Projects](#update-existing-projects) section. + ### Visual Studio 2022 Develoeprs using Visual Studio 2022 should be using the [MonoGame C# Project Templates](https://marketplace.visualstudio.com/items?itemName=MonoGame.MonoGame-Templates-VSExtension) extension. This provides not only the tempaltes but also the functinality to open the *MonoGame Content Builder Editor* (MGCB Editor) within Visual Studio. You can update the extension by performing the following From bc4deba0b25f9d9acfb08fc584392ab911a7e112 Mon Sep 17 00:00:00 2001 From: Christopher Whitley <103014489+AristurtleDev@users.noreply.github.com> Date: Fri, 16 Aug 2024 18:22:38 -0400 Subject: [PATCH 09/13] Moved uninstall templates section to a notes section --- articles/migration/updating_versions.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/articles/migration/updating_versions.md b/articles/migration/updating_versions.md index d75a8986..c233c547 100644 --- a/articles/migration/updating_versions.md +++ b/articles/migration/updating_versions.md @@ -12,7 +12,7 @@ Developers will need to update the MonoGame C# Templates used to create new proj > Updating the templates will not affect existing projects. if developers wish to update existing project, see the info in the [Update Existing Projects](#update-existing-projects) section. ### Visual Studio 2022 -Develoeprs using Visual Studio 2022 should be using the [MonoGame C# Project Templates](https://marketplace.visualstudio.com/items?itemName=MonoGame.MonoGame-Templates-VSExtension) extension. This provides not only the tempaltes but also the functinality to open the *MonoGame Content Builder Editor* (MGCB Editor) within Visual Studio. You can update the extension by performing the following +Developers using Visual Studio 2022 should be using the [MonoGame C# Project Templates](https://marketplace.visualstudio.com/items?itemName=MonoGame.MonoGame-Templates-VSExtension) extension. This provides not only the tempaltes but also the functinality to open the *MonoGame Content Builder Editor* (MGCB Editor) within Visual Studio. You can update the extension by performing the following 1. Open Visual Studio 2022 2. In the lanuch window, choose the *Continue without code* option at the bottom on the right. @@ -25,11 +25,15 @@ If prompted to close Visual Studio to finish the update, do so now to continue i Develoeprs using the dotnet CLI with environments such as Visual Studio Code, JetBrains Rider, or other editors, can exceute the following command in a command prompt/terminal to update the templates ```sh -dotnet new uninstall MonoGame.Templates.CSharp dotnet new install MonoGame.Templates.CSharp ``` -The templates must be uninstalled first before the updated tempaltes are installed; otherwise, you will see warnings about template naming conflicts between the two versions. +> [!TIP] +> If you receive a an error or warning stating there are naming conflicts in the templates, you may need to uninstall the templates first with the following command and then install them: +> +> ```sh +> dotnet new uninstall MonoGame.Templates.CSharp +> ``` Alternatively, you can perform `dotnet new update` which will update all templates installed to their most current version avaialble. However, this may affect other templates you have installed that you may not wish to update, it's an all or nothing command. From 4307d4f1c5a40759429c74457ee227d89a75a411 Mon Sep 17 00:00:00 2001 From: Christopher Whitley <103014489+AristurtleDev@users.noreply.github.com> Date: Fri, 16 Aug 2024 18:31:38 -0400 Subject: [PATCH 10/13] Swap order of sections --- articles/migration/updating_versions.md | 67 +++++++++++++------------ 1 file changed, 35 insertions(+), 32 deletions(-) diff --git a/articles/migration/updating_versions.md b/articles/migration/updating_versions.md index c233c547..c5c92e9c 100644 --- a/articles/migration/updating_versions.md +++ b/articles/migration/updating_versions.md @@ -5,38 +5,6 @@ description: A guide on updating MonoGame when a new release is pushed. When a new release of MonoGame is pushed, developers will need to manually update their development environment and/or existing project to make use of the new version. This guide is intended to walk you through the steps of performing these updates. -## Update dotnet Templates -Developers will need to update the MonoGame C# Templates used to create new projects. Doing this depends on if you are using Visual Studio 2022 or through the dotnet cli. - -> [!NOTE] -> Updating the templates will not affect existing projects. if developers wish to update existing project, see the info in the [Update Existing Projects](#update-existing-projects) section. - -### Visual Studio 2022 -Developers using Visual Studio 2022 should be using the [MonoGame C# Project Templates](https://marketplace.visualstudio.com/items?itemName=MonoGame.MonoGame-Templates-VSExtension) extension. This provides not only the tempaltes but also the functinality to open the *MonoGame Content Builder Editor* (MGCB Editor) within Visual Studio. You can update the extension by performing the following - -1. Open Visual Studio 2022 -2. In the lanuch window, choose the *Continue without code* option at the bottom on the right. -3. From the top menu choose, *Extensions > Manage Extensions* to open the *Extension Manager* panel. -4. Click the *Updates* tab and choose *MonoGame Framework C# project templates* and update it to the latest version. - -If prompted to close Visual Studio to finish the update, do so now to continue installing the update. - -### dotnet CLI (VSCode/Rider) -Develoeprs using the dotnet CLI with environments such as Visual Studio Code, JetBrains Rider, or other editors, can exceute the following command in a command prompt/terminal to update the templates - -```sh -dotnet new install MonoGame.Templates.CSharp -``` - -> [!TIP] -> If you receive a an error or warning stating there are naming conflicts in the templates, you may need to uninstall the templates first with the following command and then install them: -> -> ```sh -> dotnet new uninstall MonoGame.Templates.CSharp -> ``` - -Alternatively, you can perform `dotnet new update` which will update all templates installed to their most current version avaialble. However, this may affect other templates you have installed that you may not wish to update, it's an all or nothing command. - ## Update Existing Projects Developers wishing to update their current project to use a new release version only need to update the *target framework*, *NuGet package verions*, and *dotnet tools* version. Doing this dpeends on if you are using Visual Studio 2022 or another development environment @@ -71,3 +39,38 @@ Once these changes are made, open a command prompt or terminal at the root of th ```sh dotnet tool restore ``` + +## Updating Environment for New Projects +The following sections will cover updating your development environment for new projects. + +### Update dotnet Templates +Developers will need to update the MonoGame C# Templates used to create new projects. Doing this depends on if you are using Visual Studio 2022 or through the dotnet cli. + +> [!NOTE] +> Updating the templates will not affect existing projects. if developers wish to update existing project, see the info in the [Update Existing Projects](#update-existing-projects) section. + +#### Visual Studio 2022 +Developers using Visual Studio 2022 should be using the [MonoGame C# Project Templates](https://marketplace.visualstudio.com/items?itemName=MonoGame.MonoGame-Templates-VSExtension) extension. This provides not only the tempaltes but also the functinality to open the *MonoGame Content Builder Editor* (MGCB Editor) within Visual Studio. You can update the extension by performing the following + +1. Open Visual Studio 2022 +2. In the lanuch window, choose the *Continue without code* option at the bottom on the right. +3. From the top menu choose, *Extensions > Manage Extensions* to open the *Extension Manager* panel. +4. Click the *Updates* tab and choose *MonoGame Framework C# project templates* and update it to the latest version. + +If prompted to close Visual Studio to finish the update, do so now to continue installing the update. + +#### dotnet CLI (VSCode/Rider) +Develoeprs using the dotnet CLI with environments such as Visual Studio Code, JetBrains Rider, or other editors, can exceute the following command in a command prompt/terminal to update the templates + +```sh +dotnet new install MonoGame.Templates.CSharp +``` + +> [!TIP] +> If you receive a an error or warning stating there are naming conflicts in the templates, you may need to uninstall the templates first with the following command and then install them: +> +> ```sh +> dotnet new uninstall MonoGame.Templates.CSharp +> ``` + +Alternatively, you can perform `dotnet new update` which will update all templates installed to their most current version avaialble. However, this may affect other templates you have installed that you may not wish to update, it's an all or nothing command. From 409926d134643fe553e5a89f8570504c7b116ee2 Mon Sep 17 00:00:00 2001 From: Christopher Whitley <103014489+AristurtleDev@users.noreply.github.com> Date: Fri, 16 Aug 2024 18:47:37 -0400 Subject: [PATCH 11/13] Add section on target framework --- articles/migration/updating_versions.md | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/articles/migration/updating_versions.md b/articles/migration/updating_versions.md index c5c92e9c..e59a5589 100644 --- a/articles/migration/updating_versions.md +++ b/articles/migration/updating_versions.md @@ -6,15 +6,24 @@ description: A guide on updating MonoGame when a new release is pushed. When a new release of MonoGame is pushed, developers will need to manually update their development environment and/or existing project to make use of the new version. This guide is intended to walk you through the steps of performing these updates. ## Update Existing Projects -Developers wishing to update their current project to use a new release version only need to update the *target framework*, *NuGet package verions*, and *dotnet tools* version. Doing this dpeends on if you are using Visual Studio 2022 or another development environment +Developers wishing to update their current project to use a new release version only need to update the *target framework*, *NuGet package verions*, and *dotnet tools* version. Doing this dpeends on if you are using Visual Studio 2022 or another development environment. -### Visual Studio 2022 +### Update Target Framework +Developers will need to ensure the project is updated to target the .NET version used by MonoGame at minimum (currenty `net8.0`). To do this, open your project's *.csproj* file and find the `` element and change the `net-X.Y` version to `net-8.0`, then save the file. + +> [!NOTE] +> Only change the .NET version number. some projext types have platform specifiers such as `net6.0-windows`. The only thing that should change here is the version number. + +### Update NuGet References +The following sections cover updating your NuGet packages for existing projects based om your developmemt environment. + +#### Visual Studio 2022 Open your existing project in Visual Studio 2022 and perform the following 1. Right-click on the project in the *Solution Explorer* panel and select *Manage NuGet Packages...". 2. In the NuGet Packages Manager window, click the *Updates* tab. 3. Select the MonoGame Framework packages in the list on the left, then click the *Update* button for each one on the right. -### Manually Editing .csproj File +#### Manually Editing .csproj File (VSCode/Rider) Alternatively, regardless of the development environment, developers can manually edit the *.csproj* file for their project to update to the newest MonoGame release. To do this 1. Open your project's *.csproj* file 2. Locate the `` elements for any MonoGame referenced packages. From f8607fc0b6432dc4153de427504c3264312a3ae6 Mon Sep 17 00:00:00 2001 From: Christopher Whitley <103014489+AristurtleDev@users.noreply.github.com> Date: Fri, 16 Aug 2024 18:51:48 -0400 Subject: [PATCH 12/13] Add toc --- articles/migration/updating_versions.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/articles/migration/updating_versions.md b/articles/migration/updating_versions.md index e59a5589..83eb3c59 100644 --- a/articles/migration/updating_versions.md +++ b/articles/migration/updating_versions.md @@ -3,6 +3,23 @@ title: Updating Versions description: A guide on updating MonoGame when a new release is pushed. --- + +- [Update Existing Projects](#update-existing-projects) + - [Update Target Framework](#update-target-framework) + - [Update NuGet References](#update-nuget-references) + - [Visual Studio 2022](#visual-studio-2022) + - [Manually Editing .csproj File (VSCode/Rider)](#manually-editing-csproj-file-vscoderider) + - [Update MGCB Editor](#update-mgcb-editor) +- [Updating Environment for New Projects](#updating-environment-for-new-projects) + - [Update dotnet Templates](#update-dotnet-templates) + - [Visual Studio 2022](#visual-studio-2022-1) + - [dotnet CLI (VSCode/Rider)](#dotnet-cli-vscoderider) + - [Update MGCB Editor](#update-mgcb-editor-1) +- [Updating Environment for New Projects](#updating-environment-for-new-projects-1) + - [Update dotnet Templates](#update-dotnet-templates-1) + - [Visual Studio 2022](#visual-studio-2022-2) + - [dotnet CLI (VSCode/Rider)](#dotnet-cli-vscoderider-1). + When a new release of MonoGame is pushed, developers will need to manually update their development environment and/or existing project to make use of the new version. This guide is intended to walk you through the steps of performing these updates. ## Update Existing Projects From 63bcee6e8d51a02b12652a5ab4765003139f3f94 Mon Sep 17 00:00:00 2001 From: Christopher Whitley <103014489+AristurtleDev@users.noreply.github.com> Date: Fri, 16 Aug 2024 18:54:15 -0400 Subject: [PATCH 13/13] Fix toc --- articles/migration/updating_versions.md | 5 ----- 1 file changed, 5 deletions(-) diff --git a/articles/migration/updating_versions.md b/articles/migration/updating_versions.md index 83eb3c59..0d535ca3 100644 --- a/articles/migration/updating_versions.md +++ b/articles/migration/updating_versions.md @@ -14,11 +14,6 @@ description: A guide on updating MonoGame when a new release is pushed. - [Update dotnet Templates](#update-dotnet-templates) - [Visual Studio 2022](#visual-studio-2022-1) - [dotnet CLI (VSCode/Rider)](#dotnet-cli-vscoderider) - - [Update MGCB Editor](#update-mgcb-editor-1) -- [Updating Environment for New Projects](#updating-environment-for-new-projects-1) - - [Update dotnet Templates](#update-dotnet-templates-1) - - [Visual Studio 2022](#visual-studio-2022-2) - - [dotnet CLI (VSCode/Rider)](#dotnet-cli-vscoderider-1). When a new release of MonoGame is pushed, developers will need to manually update their development environment and/or existing project to make use of the new version. This guide is intended to walk you through the steps of performing these updates.