Merge pull request #414 from stride3d/master

Deploy latest documentation updates to staging

Author: VaclavElias

en/ReleaseNotes/ReleaseNotes.md

@@ -10,6 +10,8 @@ A massive thank you to the open-source Stride community for your dedicated contr
 
 ## Minor releases since the last major release
 
+- [4.2.0.2381](https://github.com/stride3d/stride/releases/tag/releases%2F4.2.0.2381): March 2025
+- [4.2.0.2374](https://github.com/stride3d/stride/releases/tag/releases%2F4.2.0.2374): February 2025
 - [4.2.0.2293](https://github.com/stride3d/stride/releases/tag/releases%2F4.2.0.2293): January 2025
 - [4.2.0.2282](https://github.com/stride3d/stride/releases/tag/releases%2F4.2.0.2282): December 2024
 - [4.2.0.2232](https://github.com/stride3d/stride/releases/tag/releases%2F4.2.0.2232): September 2024

en/community-resources/rendering-and-camera.md

@@ -31,4 +31,4 @@
 - [StrideCameraController](https://github.com/herocrab/StrideCameraController) - Swapping Cameras/Resident Evil Style
 - [CameraFollow.cs](https://gist.github.com/ykafia/371b310de1ba7bb8ab3d2feffce2a190)
 - [SplitScreen](https://github.com/profan/XenkoByteSized#xenkobytesizedsplitscreen)
-   
+- [Multiple Cameras in the scene](https://www.youtube.com/watch?v=_qUhcn9i_yw)

en/manual/graphics/materials/materials-for-developers.md

@@ -17,11 +17,13 @@ This diagram shows the Material interfaces and implementation classes:
 
 The file @'Stride.Rendering.Materials.MaterialKeys' contains most material keys you might need to use, have a look through it to figure out which one you might need to get to modify the parameter you are interested in.
 
-Let's say you have this fairly simple material
+Let's say you have this fairly simple material:
+
 ![media/runtime-param-modif-ex.png](media/runtime-param-modif-ex.png)
 
 And you want to clone that material, but change its color to red at runtime.
 Searching through the different keys contained in @'Stride.Rendering.Materials.MaterialKeys' you would find `MaterialKeys.DiffuseValue` and use it as the key to set the new color value you want:
+
 ```csharp
 var clone = SerializerExtensions.Clone(MyMaterial);
 clone.Passes[0].Parameters.Set(MaterialKeys.DiffuseValue, new Color4(1, 0, 0));

en/manual/index.md

@@ -13,6 +13,7 @@ These pages contain information about how to use Stride, an open-source C# game
 
 #### Manual
 
+- <span class="badge text-bg-info">Updated</span> [Graphics - Materials - Materials for developers ](graphics/materials/materials-for-developers.md) - Modifying parameters at runtime added
 - <span class="badge text-bg-success">New</span> [Scripts](scripts/best-practice.md) - Best Practises docs added
 - <span class="badge text-bg-success">New</span> [Physics](physics/index.md) - Bepu Physics docs added
 - <span class="badge text-bg-info">Updated</span> [Bullet Physics](physics-bullet/index.md) - Bullet Physics docs moved
@@ -23,7 +24,7 @@ These pages contain information about how to use Stride, an open-source C# game
 
 #### Contributing
 
-- <span class="badge text-bg-info">Updated</span> [Contributing - Roadmap](../contributors/roadmap.md) - GitHup Project - Roadmap link added
+- <span class="badge text-bg-info">Updated</span> [Contributing - Roadmap](../contributors/roadmap.md) - GitHub Project - Roadmap link added
 
 ### Previous updates
 

en/manual/scripts/create-a-model-from-code.md

@@ -154,7 +154,7 @@ var materialDescription = new MaterialDescriptor
     }
 };
 var material = Material.New(GraphicsDevice, materialDescription);
-material.Parameters[0].Set(MaterialKeys.DiffuseValue, Color.Red);
+material.Passes[0].Parameters.Set(MaterialKeys.DiffuseValue, Color.Red);
 model.Materials.Add(0, material);
 ```
 

en/manual/scripts/custom-assets.md

@@ -37,6 +37,7 @@ using Stride.Core.BuildEngine;
 using Stride.Core.Serialization;
 using Stride.Core.Serialization.Contents;
 using Stride.Engine;
+using Stride.Engine.Design;
 
 namespace YOUR_GAME_NAMESPACE;
 
@@ -45,7 +46,11 @@ namespace YOUR_GAME_NAMESPACE;
 /// </summary>
 [DataContract]
 [ContentSerializer(typeof(DataContentSerializerWithReuse<YOUR_CLASS>))]
+// The ReferenceSerializer attribute is required when specifying a DataSerializerGlobal with ReferenceSerializer<>,
+// The two of them specifies to the serializers that this class is a runtime Asset
 [ReferenceSerializer, DataSerializerGlobal(typeof(ReferenceSerializer<YOUR_CLASS>), Profile = "Content")]
+// The line below ensures that the asset's reference is re-used instead of cloned for all new instances when instantiating prefabs
+[DataSerializerGlobal(typeof(CloneSerializer<YOUR_CLASS>), Profile = "Clone")]
 public class YOUR_CLASS
 {
 	// Replace this with whatever you would want this asset to hold at runtime
@@ -122,7 +127,7 @@ public sealed class YOUR_CLASS_COMPILER : AssetCompilerBase
 ```
 
 > [!Warning]
-> Every changes made to the runtime asset will break previously built asset databases, make sure to delete the build artifacts stride generates for assets (`YOUR_PROJECT.Windows/obj/stride` and `bin/db`) after changing the class to make sure the asset database is fully rebuilt on the next build.
+> Every changes made to the runtime asset will break previously built asset databases, make sure to clean the solution or manually delete the build artifacts stride generates for assets (`YOUR_PROJECT.Windows/obj/stride` and `bin/db`) after changing the class to make sure the asset database is fully rebuilt on the next build.
 
 This takes care of the support for this asset, you could create a `*.blks` file inside your `Assets` directory and fill in the content manually, but might as well do it through the editor ...
 
@@ -189,4 +194,4 @@ And you're finally done, have fun !
 
 ## See also
 
-* [Best Practice](best-practice.md)
+* [Best Practice](best-practice.md)

en/manual/toc.yml

@@ -540,7 +540,7 @@ items:
         href: scripts/gizmos.md
       - name: Create Custom Assets
         href: scripts/custom-assets.md
-      - name: Best Practice
+      - name: Best Practices
         href: scripts/best-practice.md
 
   - name: Sprites