Merge branch 'main' into PublishSingleFile

MonoGame · Nov 6, 2024 · c5f69f5 · c5f69f5
2 parents 42b90cb + b2aac1b
commit c5f69f5
Show file tree

Hide file tree

Showing 3 changed files with 18 additions and 2 deletions.
diff --git a/articles/getting_started/2_choosing_your_ide_visual_studio.md b/articles/getting_started/2_choosing_your_ide_visual_studio.md
@@ -35,6 +35,16 @@ When installing Visual Studio, the following workloads are required depending on
 
 To create new MonoGame projects from within Visual Studio 2022, you will need to install the **MonoGame Framework C# project templates** extension.  The following steps demonstrate how to install the extension.
 
+> [!WARNING]
+> **Visual Studio Extension Issues**
+> 
+> The extension that is installed by Visual Studio 2022 is currently outdated.
+> Instead of using Visual Studio 2022 to install the templates, run the following command:
+> ```sh
+>    dotnet new install MonoGame.Templates.CSharp
+>  ```
+> After doing this, you should be able to launch Visual Studio 2022 and create a new project with the newly installed templates.
+
 1. Launch Visual Studio 2022
 2. Select **Continue without code**.  This will launch Visual Studio without any project or solution opened.
 
@@ -86,4 +96,4 @@ To get you started with Visual Studio, here are the steps for setting up a new M
 
 Next, get to know MonoGame's code structure and project layout:
 
-- [Understanding the code](3_understanding_the_code.md)
+- [Understanding the code](3_understanding_the_code.md)
diff --git a/articles/getting_started/packaging_games.md b/articles/getting_started/packaging_games.md
@@ -174,7 +174,9 @@ However, you do need to currently add some additional settings to your `.csproj`
 
 The `TrimmerRootAssembly` stops the trimmer removing code from these assemblies. This should allow the game to run without 
 any issues. However if you are using any Third Party or additional assemblies, you might need to add them to this list or fix your code to be `Aot` compliant.
-It is recommended that you publish using AOT as it simplifies the app bundle. 
+It is recommended that you publish using AOT as it simplifies the app bundle.
+
+You may see some trim and AOT analysis warnings related to MonoGame when using PublishAOT, even after adding `TrimmerRootAssembly` - these are normal and should not present any issue.
 
 See [Trim self-contained deployments and executables](https://learn.microsoft.com/en-us/dotnet/core/deploying/trimming/trim-self-contained) for more information.
 

diff --git a/articles/tutorials.md b/articles/tutorials.md
@@ -51,6 +51,10 @@ Check out the awesome work of the larger MonoGame community with their own tutor
 - [Batholith Entertainment Game dev tutorials](https://www.youtube.com/playlist?list=PLZ6ofHM1rvK8lQSoKX1USZstM-ZXikFHp)
 - [Let's Code: The T-Rex Runner Game with MonoGame](https://www.youtube.com/watch?v=DJCQVJ83J1U)
 
+## Shaders
+- [MonoGame-Pixel-Planets - a port of Pixel Planets made by DeepFold with a lot of GLSL shaders converted to HLSL](https://github.com/EnthusiastGuy/MonoGame-Pixel-Planets)
+- [MonoGame-Shader-Samples](https://github.com/cpt-max/MonoGame-Shader-Samples)
+
 ## Others
 
 - [Dark Genesis Blog MonoGame content](http://darkgenesis.zenithmoon.com/tag/monogame/)