Sample Migration (#255)

* Update checkouts

* Sample migration

Author: SimonDarksideJ

articles/toc.yml

@@ -165,6 +165,29 @@ items:
             href: tutorials/building_2d_games/26_publish_to_itch/index.md
           - name: "27: Conclusion and Next Steps"
             href: tutorials/building_2d_games/27_conclusion/index.md
+      - name: 2D Shaders
+        href: tutorials/advanced/2d_shaders/index.md
+        items:
+          - name: "01: Introduction"
+            href: tutorials/advanced/2d_shaders/01_introduction/index.md
+          - name: "02: Hot Reload"
+            href: tutorials/advanced/2d_shaders/02_hot_reload/index.md
+          - name: "03: The Material Class"
+            href: tutorials/advanced/2d_shaders/03_the_material_class/index.md
+          - name: "04: Debug UI"
+            href: tutorials/advanced/2d_shaders/04_debug_ui/index.md
+          - name: "05: Transition Effect"
+            href: tutorials/advanced/2d_shaders/05_transition_effect/index.md
+          - name: "06: Color Swap Effect"
+            href: tutorials/advanced/2d_shaders/06_color_swap_effect/index.md
+          - name: "07: Sprite Vertex Effect"
+            href: tutorials/advanced/2d_shaders/07_sprite_vertex_effect/index.md
+          - name: "08: Light Effect"
+            href: tutorials/advanced/2d_shaders/08_light_effect/index.md
+          - name: "09: Shadow Effect"
+            href: tutorials/advanced/2d_shaders/09_shadows_effect/index.md
+          - name: "10: Next Steps"
+            href: tutorials/advanced/2d_shaders/10_next_steps/index.md 
   - name: Console Access
     href: console_access.md
   - name: Help and Support

articles/tutorials/advanced/2d_shaders/01_introduction/index.md

@@ -0,0 +1,31 @@
+---
+title: "Chapter 01: Getting Started"
+description: "Prepare your project and get ready"
+---
+
+Welcome to the advanced 2D shaders tutorial! The goal of this series is to explore several concepts in MonoGame's 2D graphics capabilities, specifically with respect to shaders.
+
+## The Starting Code
+
+This tutorial series builds directly on top of the final code from the [Building 2D Games](https://docs.monogame.net/articles/tutorials/building_2d_games/index.html) tutorial. It is essential that you start with this project.
+
+> [!note]
+> You can get the complete starting source code for this tutorial here:
+> [Chapter 27 source code from Building 2D Games tutorial](https://github.com/MonoGame/MonoGame.Samples/tree/3.8.4/Tutorials/learn-monogame-2d/src/27-Conclusion/)
+
+Once you have the code downloaded, open it in your IDE and run the `DungeonSlime` project to make sure everything is working correctly. You should see the title screen from the previous tutorial.
+
+## Project Structure
+
+The solution is currently organized into two main projects:
+
+- **`DungeonSlime`**: The main game project. This contains our game logic and game-specific content.
+- **`MonoGameLibrary`**: Our reusable class library. We will be adding new, generic helper classes here that could be used in any of your future MonoGame projects.
+
+Most of our shader files (`.fx`) will be created in the `Content/effects` folder within the `DungeonSlime` project to start, and later within the `MonoGameLibrary` for shared effects.
+
+## What is Next
+
+Now that our project is set up, we can get to work. The focus for the first several chapters will be to create a workflow for developing shaders in MonoGame. Once we have a hot-reload system, a class to manage the effects, and a debug UI ready, we will carry on and build up 5 effects. The effects will range from simple pixel shaders and vertex shaders up to rendering techniques. As we develop these shaders together, we will build an intuition for how to tackle shader development.
+
+Continue to the next chapter, [Chapter 02: Hot Reload](../02_hot_reload/index.md).

articles/tutorials/advanced/2d_shaders/02_hot_reload/images/background-watcher.png

@@ -0,0 +1,5 @@
+<ItemGroup>
+    <PackageReference Include="Gum.MonoGame" Version="2025.12.9.1" />
+    <PackageReference Include="MonoGame.Framework.DesktopGL" Version="3.8.*" />
+    <PackageReference Include="MonoGame.Content.Builder.Task" Version="3.8.*" />
+</ItemGroup>

articles/tutorials/advanced/2d_shaders/02_hot_reload/images/game.png

@@ -0,0 +1,42 @@
+#region declaration
+using System;
+using Microsoft.Xna.Framework.Content;
+
+namespace MonoGameLibrary.Content;
+
+public class WatchedAsset<T>
+{
+
+}
+
+#endregion
+{
+#region members
+    /// <summary>
+    /// The latest version of the asset.
+    /// </summary>
+    public T Asset { get; set; }
+
+    /// <summary>
+    /// The last time the <see cref="Asset"/> was loaded into memory.
+    /// </summary>
+    public DateTimeOffset UpdatedAt { get; set; }
+
+    /// <summary>
+    /// The name of the <see cref="Asset"/>. This is the name used to load the asset from disk. 
+    /// </summary>
+    public string AssetName { get; init; }
+
+    /// <summary>
+    /// The <see cref="ContentManager"/> instance that loaded the asset.
+    /// </summary>
+    public ContentManager Owner { get; init; }
+    #endregion
+
+    #region methods
+    public bool TryRefresh(out T oldAsset)
+    {
+        return Owner.TryRefresh(this, out oldAsset);
+    }
+    #endregion
+}

articles/tutorials/advanced/2d_shaders/02_hot_reload/index.md

@@ -0,0 +1,36 @@
+{
+  "version": 1,
+  "isRoot": true,
+  "tools": {
+    "dotnet-mgcb": {
+      "version": "3.8.4",
+      "commands": [
+        "mgcb"
+      ]
+    },
+    "dotnet-mgcb-editor": {
+      "version": "3.8.4",
+      "commands": [
+        "mgcb-editor"
+      ]
+    },
+    "dotnet-mgcb-editor-linux": {
+      "version": "3.8.4",
+      "commands": [
+        "mgcb-editor-linux"
+      ]
+    },
+    "dotnet-mgcb-editor-windows": {
+      "version": "3.8.4",
+      "commands": [
+        "mgcb-editor-windows"
+      ]
+    },
+    "dotnet-mgcb-editor-mac": {
+      "version": "3.8.4",
+      "commands": [
+        "mgcb-editor-mac"
+      ]
+    }
+  }
+}

articles/tutorials/advanced/2d_shaders/02_hot_reload/snippets/DungeonSlime.csproj

@@ -0,0 +1,7 @@
+  <Target
+    Name="IncludeContent"
+    DependsOnTargets="RunContentBuilder"
+    Condition="('$(EnableMGCBItems)' == 'true' OR '@(MonoGameContentReference)' != '') And '$(DesignTimeBuild)' != 'true'"
+    Outputs="%(ExtraContent.RecursiveDir)%(ExtraContent.Filename)%(ExtraContent.Extension)"
+    BeforeTargets="BeforeCompile"
+    AfterTargets="ResolveProjectReferences">

articles/tutorials/advanced/2d_shaders/02_hot_reload/snippets/WatchedAsset.cs

@@ -0,0 +1 @@
+dotnet build -t:IncludeContent