From a603015ae6a579420fa82c13f49f9ec354bd5044 Mon Sep 17 00:00:00 2001 From: Jorn Theunissen Date: Sun, 12 Nov 2023 11:11:31 +0100 Subject: [PATCH 01/13] Update toc.yml asset introspection --- en/contributors/toc.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/en/contributors/toc.yml b/en/contributors/toc.yml index 55c919195..1e55d21d9 100644 --- a/en/contributors/toc.yml +++ b/en/contributors/toc.yml @@ -34,7 +34,7 @@ - name: Dependency graph href: engine/architecture/dependency-graph.md - name: Asset introspection - href: engine/architecture/build-pipeline.md + href: engine/architecture/asset-introspection.html - name: 🎓 Contribute to the documentation expanded: false href: documentation/index.md @@ -70,4 +70,4 @@ - name: Deployment href: website/deployment-azure.md - name: Troubleshooting and FAQ - href: website/troubleshooting-and-faq.md \ No newline at end of file + href: website/troubleshooting-and-faq.md From 58115e116c5422a1f9e4850eeccb82696ab8d2c4 Mon Sep 17 00:00:00 2001 From: JornosDesktop Date: Mon, 13 Nov 2023 20:12:17 +0100 Subject: [PATCH 02/13] Remove outdated Ticket reference --- en/contributors/engine/architecture/build-details.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/en/contributors/engine/architecture/build-details.md b/en/contributors/engine/architecture/build-details.md index d6cdfb27a..00ef41d1b 100644 --- a/en/contributors/engine/architecture/build-details.md +++ b/en/contributors/engine/architecture/build-details.md @@ -11,9 +11,8 @@ We use `TargetFrameworks` to properly compile the different platforms using a si Also, we use `RuntimeIdentifiers` to select graphics platform. [MSBuild.Sdk.Extras](https://github.com/onovotny/MSBuildSdkExtras) is used to properly build NuGet packages with multiple `RuntimeIdentifiers` (not supported out of the box). ### Limitations - * Dependencies are per `TargetFramework` and can't be done per `RuntimeIdentifier` (tracked in [NuGet#1660](https://github.com/NuGet/Home/issues/1660)). -* FastUpToDate check doesn't work with multiple `TargetFrameworks` (tracked in [project-system#2487](https://github.com/dotnet/project-system/issues/2487)). + ## NuGet resolver From 264bc97e7444805e686023502a94bd2e3ee0b8a4 Mon Sep 17 00:00:00 2001 From: JornosDesktop Date: Mon, 13 Nov 2023 20:14:37 +0100 Subject: [PATCH 03/13] removed WIP --- en/contributors/engine/architecture/asset-introspection.md | 6 ------ 1 file changed, 6 deletions(-) diff --git a/en/contributors/engine/architecture/asset-introspection.md b/en/contributors/engine/architecture/asset-introspection.md index 8a9ed2fdc..9ea23f2ed 100644 --- a/en/contributors/engine/architecture/asset-introspection.md +++ b/en/contributors/engine/architecture/asset-introspection.md @@ -1,11 +1,5 @@ # Asset, introspection and prefab -https://github.com/stride3d/stride/edit/master/docs/technical/asset-introspection.md -WIP: COPIED from link above - - -## Assets - *NOTE: Please read the Terminology section of the [Build Pipeline](build-pipeline.md) documentation first* ### Design notes From 4671ffae6657b15fb8bbddd23616b1022e0f98d8 Mon Sep 17 00:00:00 2001 From: JornosDesktop Date: Mon, 13 Nov 2023 20:52:29 +0100 Subject: [PATCH 04/13] donate.md instructions adjusted --- en/contributors/donate.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/en/contributors/donate.md b/en/contributors/donate.md index 40a5e7082..2137588cc 100644 --- a/en/contributors/donate.md +++ b/en/contributors/donate.md @@ -5,4 +5,6 @@ In order to support our contributors or if we want to finance a specific feature We gather funding through a website called [OpenCollective](https://opencollective.com/stride3d). This website displays where all the money is coming from and where it is going to: 100% transparency guaranteed. ## Projects -Stride's Open Collective hosts different '[Projects](https://opencollective.com/stride3d/projects)' — think of them as funding goals for specific features or contributions. Each project typically has a related GitHub ticket for more details on what's required for its development. If you're interested in working on or contributing to a particular feature, please reply in the thread and mention @stride3d/stride-contributors. +Stride's Open Collective hosts different '[Projects](https://opencollective.com/stride3d/projects)' — think of them as funding goals for specific features or contributions. Each project typically has a related GitHub ticket for more details on what's required for its development. If you're interested in working on or contributing to a particular feature, you can let us know by either replying: + - In each projects related Github thread and mention @stride3d/stride-contributors + - In the Stride [Contributors channel on Discord](https://discord.gg/bDhMhGVHvD). From d27c0e09434d534a36bc2a3459137146d69a13aa Mon Sep 17 00:00:00 2001 From: JornosDesktop Date: Mon, 13 Nov 2023 20:52:50 +0100 Subject: [PATCH 05/13] stupid dot --- en/contributors/donate.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en/contributors/donate.md b/en/contributors/donate.md index 2137588cc..712ec2b5a 100644 --- a/en/contributors/donate.md +++ b/en/contributors/donate.md @@ -7,4 +7,4 @@ We gather funding through a website called [OpenCollective](https://opencollecti ## Projects Stride's Open Collective hosts different '[Projects](https://opencollective.com/stride3d/projects)' — think of them as funding goals for specific features or contributions. Each project typically has a related GitHub ticket for more details on what's required for its development. If you're interested in working on or contributing to a particular feature, you can let us know by either replying: - In each projects related Github thread and mention @stride3d/stride-contributors - - In the Stride [Contributors channel on Discord](https://discord.gg/bDhMhGVHvD). + - In the Stride [Contributors channel on Discord](https://discord.gg/bDhMhGVHvD) From e8f76bd45a11cb84e45ef4ce44dcda3bd4248b88 Mon Sep 17 00:00:00 2001 From: Vaclav Elias Date: Tue, 14 Nov 2023 20:09:12 +0100 Subject: [PATCH 06/13] feat: Version 4.1 added --- en/ReleaseNotes/ReleaseNotes-4.1.md | 150 ++++++++++++++++++++++++++++ 1 file changed, 150 insertions(+) create mode 100644 en/ReleaseNotes/ReleaseNotes-4.1.md diff --git a/en/ReleaseNotes/ReleaseNotes-4.1.md b/en/ReleaseNotes/ReleaseNotes-4.1.md new file mode 100644 index 000000000..1288a9cf4 --- /dev/null +++ b/en/ReleaseNotes/ReleaseNotes-4.1.md @@ -0,0 +1,150 @@ +# Stride 4.1 Release Notes + +July 16th, 2022 + +Stride contributors are proud to announce a new release now running on **.NET 6** supporting the latest **C# 10**. That means you can now head to the download page and start developing your games using the latest .NET technologies. + +## Improvements Summary + +Here's a non-exhaustive list of new improvements: + +- .NET 6 support and [VS 2022 plugin](https://github.com/stride3d/stride/pull/1221) + - Stride 4.1 leverages the power of .NET 6 + - Support for C# 10 +- [Dithered shadows for semi-transparent materials](https://github.com/stride3d/stride/pull/1256) +- [Physics constraints](https://github.com/stride3d/stride/pull/1114) + - Bullet constraints wrapped around in easy to use functionality + - Editor gizmos for physics constraints +- [Physics performance optimization](https://github.com/stride3d/stride/pull/1100) +- [ACES tonemaping](https://github.com/stride3d/stride/pull/1037) +- [Fog image effect](https://github.com/stride3d/stride/pull/1039) +- [Outline image effect](https://github.com/stride3d/stride/pull/1038) +- [Improved editor gizmos](https://github.com/stride3d/stride/pull/1083) +- [C# Intermediate tutorials project](https://github.com/stride3d/stride/pull/1401) + - This Open Collective sub-project was [successfully funded](https://opencollective.com/stride3d/projects/stride-intermediate-tutorials) by the community. All related video recordings are available on Stride's [Youtube channel](https://www.youtube.com/c/Stride3D) and the [tutorials page](https://doc.stride3d.net/latest/en/tutorials/index.html) in the documentation will also be update to reflect the new project. +- Many more minor fixes and quality of life improvements + - [Fixed sample game](https://github.com/stride3d/stride/pull/1217) + - [Simpler Procedural Model creation](https://github.com/stride3d/stride/pull/1285) + - New math signatures ([1122](https://github.com/stride3d/stride/pull/1122), [1121](https://github.com/stride3d/stride/pull/1121), [1090](https://github.com/stride3d/stride/pull/1090)) + - Dispatcher/threadpool improvements + - Ambient Occlusion quality improvement + - And many other fixes + +## Dithered shadows for semi-transparent materials + +Produces semi-transparent shadows by poking more and more holes in the shadow map based on the transparency of the object, shadow map filtering will blur those holes with their neighbor which will result in those partially opaque pixels. + +![Dithered shadow settings](https://i.imgur.com/xFzuNbl.png) + +![Dithered shadow effect comparison](https://i.imgur.com/kHvSy8a.png) + + +## Physics constraints + +Stride's physics system Bullet comes with a set of constraints for you to use in your projects. These constraints are now all visible inside the editor, previewing the constraints using various editor gizmo. + +![preview(to be removed)](https://i.imgur.com/qiaBBpm.png) + +For more information on all the types of constraints, you can read up about them in the [Stride documentation](https://doc.stride3d.net/latest/en/manual/physics/constraints.html) or watch the video below. + +> [!Video https://www.youtube.com/embed/uMZMYpMD3Wg] + +## Physics optimizations + +Retrieving collision and contact information was previously done by re-testing all components for collisions, which, as one might expect, led to awful performance for physics heavy scenes (could take up to and above 90% of the frame). + +Contacts are now lazily evaluated to reduce overhead when nothing ends up reading them. +Users can now read and iterate over all collisions through Simulation.CurrentCollisions. + +## Improved editor gizmos + +The old gizmos weren't very nice to look at, so this feature makes them look better and more user-friendly. It also changes how the rotation gizmo works and adds scale planes to the scale gizmo. + +![New gizmos](https://i.imgur.com/8siM2Lc.png) + +This feature also updates the text on the CameraOrientationGizmo to be XYZ instead of right/left. Still prefer the old text instead of the XYZ coordinate? Don't worry, there's a setting under the viewport settings that swaps it back to the old text. + +![Rotation](https://i.imgur.com/W4zIf7J.png =400x160) + + +## Intermediate tutorials + +One of the first Open Collective sub-projects is the [intermediate C# tutorials project](https://opencollective.com/stride3d/projects/stride-intermediate-tutorials). After discussion in community meetings and with various contributors donating directly to this project, the amount for this project to be included in Stride quickly became a realization. + +![Intermediate tutorials intro screen](https://i.imgur.com/7GVEiSR.jpg) + +With Stride 4.1, you will be able to select the C# intermediate tutorials project as a new template project. The template project contains (at the moment of writing) 11 topics that every developer will want to have a look at. +1. UI basics +1. Collision triggers +1. Raycasting +1. Projecting and Unprojecting +1. Async(hronous) scripts +1. Scene loading +1. Animation basics +1. Audio +1. First person camera +1. Third person camera +1. Navigation + +Each tutorial has a video tutorial accompanying it, which can be found on Stride's [Youtube channel](https://www.youtube.com/c/Stride3D). Below you can find the full playlist. + + + > [!Video https://www.youtube.com/embed/videoseries?list=PLRZx2y7uC8mOE6_L0ZiFxNBE7HmzU2dP7] + +## Known Issues + +### Integrated C# Editor + +The transition to .NET6 unfortunately broke the help tooltips and the code completion of integrated C# code editor. But we decided to accept it for now, as everyone is using a proper C# editor anyways, such as Visual Studio, Rider or Visual Studio Code. + +The reason for the error is that [RoslynPad](https://github.com/roslynpad/roslynpad), the underlaying library, also needs an update or fix. We'll adress this in one of the upcoming minor version releases. + +![](https://i.imgur.com/Gn2i6Js.png) + + +## A little help + +We, contributors, believe that Stride can help .NET game developers make the games they want with ease using their favorite languages. We want to make sure Stride offers the most comfortable environment for developing games, and this takes time and effort. + +Since the free and open-source release of Stride, the community has been growing slowly, so we have decided to open a fund to reward developers for any contribution they make to Stride. We set up an [Open Collective page](https://opencollective.com/stride3d) to manage our funds and allocate money for features that the community would like to see implemented. + +We have various bounties for [bug fixes and features](https://opencollective.com/stride3d/projects) (Vulkan support, decals, morph targets, and many others). If you have or know someone with the skills to tackle those bounties, please reach out to us through the [respective GitHub tickets](https://github.com/stride3d/stride/labels/bounty). You can also contact us through our discord server or on GitHub to propose new bounties. + +## Contributors + +Many thanks to [all the contributors](https://github.com/stride3d/stride/graphs/contributors?from=2021-02-01&to=2022-06-10&type=c) who have donated their time and skill by adding features, fixing bugs, managing the build pipelines, adding documentation, and reviewing PRs. + +### Financial contributors + +Also, a huge thanks to the individuals and companies who contributed financially to our [Open Collective](https://opencollective.com/stride3d)! + +* [ORE System](https://ore-system.com) with a diamond sponsorship +* [xen2](https://opencollective.com/xen2) Core contributor that donated a large portion of the previous Patreon back through Open collective +* [vvvv](https://visualprogramming.net) A visual live-programming environment for easy prototyping and development. It is designed to facilitate the handling of large media environments with physical interfaces, real-time motion graphics, audio and video that can interact with many users simultaneously. vvvv uses Stride +* [Vašo](https://opencollective.com/vaclav) +* [Mitchel Albertz](https://opencollective.com/mitchel-albertz) +* [Bill](https://opencollective.com/bill2) +* [Ideonella](https://opencollective.com/ideonella) +* [Soul Rider](https://opencollective.com/soul-rider) +* [najak3d](https://opencollective.com/guest-ce7ccb03) +* [Eideren](https://opencollective.com/eideren) +* [Jorn Aggror](https://opencollective.com/jorn-theunissen) +* [Marian Dziubiak](https://marian.dziubiak.pl) +* [Youness KAFIA](https://opencollective.com/guest-7253cc41) +* [David Thunderclown](https://www.disruptionworks.co.uk) +* [Christian Clavet](https://opencollective.com/christian-clavet) +* [Marko Viitanen](https://opencollective.com/fador) +* [Aaron Disibio](https://opencollective.com/guest-2f41a631) +* [z16](https://opencollective.com/z16) +* [Incognito](https://opencollective.com/guest-5635aca5) +* [Walter Hulsebos](https://opencollective.com/guest-2170ad46) +* [TheKeyblader](https://opencollective.com/thekeyblader) +* [James Rinker](https://opencollective.com/james-rinker) +* [ztl](https://opencollective.com/guest-6653841d) +* [Bruno Garcia](https://brunogarcia.com) +* [BanditRevolver](https://opencollective.com/banditrevolver) +* [EmmX](https://opencollective.com/emmx) +* [SeleDreams](https://opencollective.com/seledreams) +* [Vignette](https://vignetteapp.org) +* [Longplay Games](https://opencollective.com/guest-a5fa78c8) +* [Redberd36](https://opencollective.com/guest-3fc8bf91) From 6e802fa25fad25d5a488a392c1a78f86d098f60f Mon Sep 17 00:00:00 2001 From: Vaclav Elias Date: Tue, 14 Nov 2023 20:18:03 +0100 Subject: [PATCH 07/13] feat: 4.2 Release notes added --- en/ReleaseNotes/ReleaseNotes.md | 125 +++++++------------------------- en/ReleaseNotes/toc.yml | 4 +- 2 files changed, 30 insertions(+), 99 deletions(-) diff --git a/en/ReleaseNotes/ReleaseNotes.md b/en/ReleaseNotes/ReleaseNotes.md index ab49857ca..57b109cca 100644 --- a/en/ReleaseNotes/ReleaseNotes.md +++ b/en/ReleaseNotes/ReleaseNotes.md @@ -1,106 +1,35 @@ -# Stride 4.1 Release Notes +# Stride 4.2 Release Notes -July 16th, 2022 +November 15th, 2023 -Stride contributors are proud to announce a new release now running on **.NET 6** supporting the latest **C# 10**. That means you can now head to the download page and start developing your games using the latest .NET technologies. +Stride contributors are proud to announce a new release now running on **.NET 8** supporting the latest **C# 12**. That means you can now head to the download page and start developing your games using the latest .NET technologies. ## Improvements Summary Here's a non-exhaustive list of new improvements: -- .NET 6 support and [VS 2022 plugin](https://github.com/stride3d/stride/pull/1221) - - Stride 4.1 leverages the power of .NET 6 - - Support for C# 10 -- [Dithered shadows for semi-transparent materials](https://github.com/stride3d/stride/pull/1256) -- [Physics constraints](https://github.com/stride3d/stride/pull/1114) - - Bullet constraints wrapped around in easy to use functionality - - Editor gizmos for physics constraints -- [Physics performance optimization](https://github.com/stride3d/stride/pull/1100) -- [ACES tonemaping](https://github.com/stride3d/stride/pull/1037) -- [Fog image effect](https://github.com/stride3d/stride/pull/1039) -- [Outline image effect](https://github.com/stride3d/stride/pull/1038) -- [Improved editor gizmos](https://github.com/stride3d/stride/pull/1083) -- [C# Intermediate tutorials project](https://github.com/stride3d/stride/pull/1401) - - This Open Collective sub-project was [successfully funded](https://opencollective.com/stride3d/projects/stride-intermediate-tutorials) by the community. All related video recordings are available on Stride's [Youtube channel](https://www.youtube.com/c/Stride3D) and the [tutorials page](https://doc.stride3d.net/latest/en/tutorials/index.html) in the documentation will also be update to reflect the new project. -- Many more minor fixes and quality of life improvements - - [Fixed sample game](https://github.com/stride3d/stride/pull/1217) - - [Simpler Procedural Model creation](https://github.com/stride3d/stride/pull/1285) - - New math signatures ([1122](https://github.com/stride3d/stride/pull/1122), [1121](https://github.com/stride3d/stride/pull/1121), [1090](https://github.com/stride3d/stride/pull/1090)) - - Dispatcher/threadpool improvements - - Ambient Occlusion quality improvement - - And many other fixes - -## Dithered shadows for semi-transparent materials - -Produces semi-transparent shadows by poking more and more holes in the shadow map based on the transparency of the object, shadow map filtering will blur those holes with their neighbor which will result in those partially opaque pixels. - -![Dithered shadow settings](https://i.imgur.com/xFzuNbl.png) - -![Dithered shadow effect comparison](https://i.imgur.com/kHvSy8a.png) - - -## Physics constraints - -Stride's physics system Bullet comes with a set of constraints for you to use in your projects. These constraints are now all visible inside the editor, previewing the constraints using various editor gizmo. - -![preview(to be removed)](https://i.imgur.com/qiaBBpm.png) - -For more information on all the types of constraints, you can read up about them in the [Stride documentation](https://doc.stride3d.net/latest/en/manual/physics/constraints.html) or watch the video below. - -> [!Video https://www.youtube.com/embed/uMZMYpMD3Wg] - -## Physics optimizations - -Retrieving collision and contact information was previously done by re-testing all components for collisions, which, as one might expect, led to awful performance for physics heavy scenes (could take up to and above 90% of the frame). - -Contacts are now lazily evaluated to reduce overhead when nothing ends up reading them. -Users can now read and iterate over all collisions through Simulation.CurrentCollisions. - -## Improved editor gizmos - -The old gizmos weren't very nice to look at, so this feature makes them look better and more user-friendly. It also changes how the rotation gizmo works and adds scale planes to the scale gizmo. - -![New gizmos](https://i.imgur.com/8siM2Lc.png) - -This feature also updates the text on the CameraOrientationGizmo to be XYZ instead of right/left. Still prefer the old text instead of the XYZ coordinate? Don't worry, there's a setting under the viewport settings that swaps it back to the old text. - -![Rotation](https://i.imgur.com/W4zIf7J.png =400x160) - - -## Intermediate tutorials - -One of the first Open Collective sub-projects is the [intermediate C# tutorials project](https://opencollective.com/stride3d/projects/stride-intermediate-tutorials). After discussion in community meetings and with various contributors donating directly to this project, the amount for this project to be included in Stride quickly became a realization. - -![Intermediate tutorials intro screen](https://i.imgur.com/7GVEiSR.jpg) - -With Stride 4.1, you will be able to select the C# intermediate tutorials project as a new template project. The template project contains (at the moment of writing) 11 topics that every developer will want to have a look at. -1. UI basics -1. Collision triggers -1. Raycasting -1. Projecting and Unprojecting -1. Async(hronous) scripts -1. Scene loading -1. Animation basics -1. Audio -1. First person camera -1. Third person camera -1. Navigation - -Each tutorial has a video tutorial accompanying it, which can be found on Stride's [Youtube channel](https://www.youtube.com/c/Stride3D). Below you can find the full playlist. - - - > [!Video https://www.youtube.com/embed/videoseries?list=PLRZx2y7uC8mOE6_L0ZiFxNBE7HmzU2dP7] - -## Known Issues - -### Integrated C# Editor - -The transition to .NET6 unfortunately broke the help tooltips and the code completion of integrated C# code editor. But we decided to accept it for now, as everyone is using a proper C# editor anyways, such as Visual Studio, Rider or Visual Studio Code. - -The reason for the error is that [RoslynPad](https://github.com/roslynpad/roslynpad), the underlaying library, also needs an update or fix. We'll adress this in one of the upcoming minor version releases. - -![](https://i.imgur.com/Gn2i6Js.png) - +- Full compatibility with .NET 8, taking advantage of [improved runtime performance](https://devblogs.microsoft.com/dotnet/performance-improvements-in-net-8/) +- Support for the latest [C# 12 features](https://devblogs.microsoft.com/dotnet/announcing-csharp-12/), enhancing coding efficiency and reducing boilerplate code +- [Changed Assimp binding to Silk.Net.Assimp #1158](https://github.com/stride3d/stride/pull/1158) +- [Can not create "C# Beginner" project. #1650](https://github.com/stride3d/stride/issues/1650) +- [C# Beginner Tutorial Build Errors #1652](https://github.com/stride3d/stride/issues/1652) +- [Game Studio doesnt reload sub projects after changes #1703](https://github.com/stride3d/stride/issues/1703) + - [fix #1703 Changing the comparison project related and not UPath related #1704](https://github.com/stride3d/stride/pull/1704) +- [Translations fix #1717](https://github.com/stride3d/stride/pull/1717) +- [Change Assimp to Silk.NET.Assimp implementation #1719](https://github.com/stride3d/stride/pull/1719) +- [Runtime rasterized fonts are completely broken #1750](https://github.com/stride3d/stride/issues/1750) +- [Migration NET6+ and more gettextnet#2](https://github.com/stride3d/gettextnet/pull/2) +- [Added the ability to copy imported assets automatically to the Resources dir #1827](https://github.com/stride3d/stride/pull/1827) +- [Feature: Add Support for F# and VB Project Types #1821](https://github.com/stride3d/stride/pull/1821), currently only for code-only projects + - [F# examples](https://stride3d.github.io/stride-community-toolkit/manual/code-only/examples/basic-examples-fs.html) + - [Visual Basic examples](https://stride3d.github.io/stride-community-toolkit/manual/code-only/examples/basic-examples-vb.html) +- [[Editor] Add dynamic snapping for selected objects #1801](https://github.com/stride3d/stride/pull/1801) +- [Stride Diagnostics Analyzer #1864](https://github.com/stride3d/stride/pull/1864) +- [Let the user pick which animation stack to import in an fbx #1977](https://github.com/stride3d/stride/pull/1977) +- [[OpenVR] Handle custom resolution specified by the user through VR settings #2000](https://github.com/stride3d/stride/pull/2000) + + + ## A little help @@ -108,11 +37,11 @@ We, contributors, believe that Stride can help .NET game developers make the gam Since the free and open-source release of Stride, the community has been growing slowly, so we have decided to open a fund to reward developers for any contribution they make to Stride. We set up an [Open Collective page](https://opencollective.com/stride3d) to manage our funds and allocate money for features that the community would like to see implemented. -We have various bounties for [bug fixes and features](https://opencollective.com/stride3d/projects) (Vulkan support, decals, morph targets, and many others). If you have or know someone with the skills to tackle those bounties, please reach out to us through the [respective Github tickets](https://github.com/stride3d/stride/labels/bounty). You can also contact us through our discord server or on Github to propose new bounties. +We have various bounties for [bug fixes and features](https://opencollective.com/stride3d/projects) (Vulkan support, decals, morph targets, and many others). If you have or know someone with the skills to tackle those bounties, please reach out to us through the [respective GitHub tickets](https://github.com/stride3d/stride/labels/bounty). You can also contact us through our discord server or on GitHub to propose new bounties. ## Contributors -Many thanks to [all the contributors](https://github.com/stride3d/stride/graphs/contributors?from=2021-02-01&to=2022-06-10&type=c) who have donated their time and skill by adding features, fixing bugs, managing the build pipelines, adding documentation, and reviewing PRs. +Many thanks to [all the contributors](https://github.com/stride3d/stride/graphs/contributors?from=2022-06-10&to=2023-11-14&type=c) who have donated their time and skill by adding features, fixing bugs, managing the build pipelines, adding documentation, and reviewing PRs. ### Financial contributors diff --git a/en/ReleaseNotes/toc.yml b/en/ReleaseNotes/toc.yml index becc95afa..0e34021d3 100644 --- a/en/ReleaseNotes/toc.yml +++ b/en/ReleaseNotes/toc.yml @@ -1,5 +1,7 @@ -- name: 4.1 release notes +- name: 4.2 release notes href: ReleaseNotes.md +- name: 4.1 release notes + href: ReleaseNotes-4.1.md - name: 4.0 release notes href: ReleaseNotes-4.0.md - name: 3.1 release notes From c5a9e42fa67647f5912832b067412ff968f2268a Mon Sep 17 00:00:00 2001 From: Vaclav Elias Date: Wed, 15 Nov 2023 22:40:59 +0000 Subject: [PATCH 08/13] feat: Major version release instructions added for the website updates --- en/contributors/website/index.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/en/contributors/website/index.md b/en/contributors/website/index.md index b39c5fd6e..4c0b7fa37 100644 --- a/en/contributors/website/index.md +++ b/en/contributors/website/index.md @@ -1,4 +1,4 @@ -# Contributing to the Stride website +# Contributing to the Stride website This documentation serves as a comprehensive guide to help you navigate and contribute to the **Stride website**. If you're looking to make minor changes, such as adding or updating a post or page, or fixing a typo, you can jump straight to the [Content Updates](content.md#content-updates) section. @@ -22,6 +22,15 @@ Technologies we use to build our website: - https://www.stride3d.net/feed.xml - This feed is loaded in the Stride Launcher +## Major Version Release Instructions + +1. Create a release blog post +1. Update `_data\site.json` with these settings, which are used in multiple places on the website: + - `version`: Increase the version number + - `download-version`: Update the version number for downloads + - `csharp-version`: Update to the current C# version being used + - `dotnet-version`: Update to the current .NET version being used + ## Table of Contents - [Installation](installation.md) From 322188693433c395989fd2823f50f3aa7dd19bf5 Mon Sep 17 00:00:00 2001 From: Vaclav Elias Date: Wed, 15 Nov 2023 23:01:16 +0000 Subject: [PATCH 09/13] feat: Major Version Release Instructions added for Stride docs --- en/contributors/documentation/index.md | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/en/contributors/documentation/index.md b/en/contributors/documentation/index.md index 19d1925a4..e45ab2f39 100644 --- a/en/contributors/documentation/index.md +++ b/en/contributors/documentation/index.md @@ -1,4 +1,4 @@ -# Contributing to documentation +# Contributing to documentation This documentation serves as a comprehensive guide to help you navigate and contribute to the **Stride Docs** website. If you're looking to make minor changes, such as adding or updating a manual, tutorial or page, or fixing a typo, feel free to jump straight to the [Content Updates](content.md#content-updates) section. @@ -16,6 +16,25 @@ Here are the technologies we use to build our website: - PowerShell scripts - GitHub Actions (CI/CD) - Don't worry, this is already set up, you don't need to worry about it. +## Major Version Release Instructions + +Assuming the transition is from version `4.1` to `4.2`, and that the Stride source code has been updated to the corresponding .NET version, follow these steps. Note that some steps can be executed at a later stage if needed. + +1. Duplicate `ReleaseNotes\ReleaseNotes.md` and rename the copy to `ReleaseNotes-4.1.md` +1. Update `ReleaseNotes.md`: + - Change the content title to `4.2` + - Replace the content with the new release notes for version `4.2` +1. Modify `ReleaseNotes\toc.yml` + - `name: 4.2 release notes` with `href: ReleaseNotes.md` + - `name: 4.1 release notes` with `href: ReleaseNotes-4.1.md` +1. In `en\docfx.json` + - `_appFooter`: Increase the version number + - Change `TargetFramework` to the current framework version being used. Ensure to test this step locally +1. Edit `versions.json` + - Under `versions`, add the new version `4.2` + +The `BuildDocs.ps1` script will manage the deployment to the `4.2` folder while maintaining accessibility to previous versions. + ## Table of Contents - [Understanding the Stride Documentation Generation Pipeline](documentation-generation-pipeline.md) From c230d94dbab2e4103b7de6ad414203321d51cd6f Mon Sep 17 00:00:00 2001 From: Vaclav Elias Date: Wed, 15 Nov 2023 23:05:11 +0000 Subject: [PATCH 10/13] Update donate.md - Upper case corrected --- en/contributors/donate.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en/contributors/donate.md b/en/contributors/donate.md index 712ec2b5a..7363cf919 100644 --- a/en/contributors/donate.md +++ b/en/contributors/donate.md @@ -6,5 +6,5 @@ We gather funding through a website called [OpenCollective](https://opencollecti ## Projects Stride's Open Collective hosts different '[Projects](https://opencollective.com/stride3d/projects)' — think of them as funding goals for specific features or contributions. Each project typically has a related GitHub ticket for more details on what's required for its development. If you're interested in working on or contributing to a particular feature, you can let us know by either replying: - - In each projects related Github thread and mention @stride3d/stride-contributors + - In each projects related GitHub thread and mention @stride3d/stride-contributors - In the Stride [Contributors channel on Discord](https://discord.gg/bDhMhGVHvD) From 433b3002f7f0535ce28c8604d5a9d18a901fbb2f Mon Sep 17 00:00:00 2001 From: Vaclav Elias Date: Thu, 16 Nov 2023 18:21:32 +0000 Subject: [PATCH 11/13] feat: 4.2 updates --- en/docfx.json | 6 +++--- versions.json | 1 + 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/en/docfx.json b/en/docfx.json index e4c5696f2..e3f5aaa43 100644 --- a/en/docfx.json +++ b/en/docfx.json @@ -25,7 +25,7 @@ ], "src": "../../stride", "properties": { - "TargetFramework": "net6.0", + "TargetFramework": "net8.0", "StrideBuildDoc": "true" } }, @@ -36,7 +36,7 @@ ], "src": "../../stride", "properties": { - "TargetFramework": "net6.0-windows7.0", + "TargetFramework": "net8.0-windows7.0", "StrideBuildDoc": "true" } } @@ -58,7 +58,7 @@ "_enableSearch": true, "_appLogoPath": "media/stride-logo-red.svg", "_appLogoUrl": "https://www.stride3d.net/", - "_appFooter": "

Supported by the .NET Foundation

Made with docfx

Stride Docs Website v.2.0.0.7

© .NET Foundation and Contributors

", + "_appFooter": "

Supported by the .NET Foundation

Made with docfx

Stride Docs Website v.2.0.0.8

© .NET Foundation and Contributors

", "_gitContribute": { "repo": "https://github.com/stride3d/stride-docs", "branch": "master" diff --git a/versions.json b/versions.json index 867ffffda..a509e9c1e 100644 --- a/versions.json +++ b/versions.json @@ -1,5 +1,6 @@ { "versions": [ + "4.2", "4.1", "4.0", "3.1", From ab6ec9c08c229f68b02e0b7b31895285472a0bcb Mon Sep 17 00:00:00 2001 From: Vaclav Elias Date: Thu, 16 Nov 2023 18:27:35 +0000 Subject: [PATCH 12/13] feat: GitHub Actions updated --- .github/workflows/stride-docs-release-azure.yml | 2 +- .github/workflows/stride-docs-release-fast-track-azure.yml | 2 +- .github/workflows/stride-docs-staging-azure.yml | 2 +- .github/workflows/stride-docs-staging-fast-track-azure.yml | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/.github/workflows/stride-docs-release-azure.yml b/.github/workflows/stride-docs-release-azure.yml index a9a3a7f01..309d21533 100644 --- a/.github/workflows/stride-docs-release-azure.yml +++ b/.github/workflows/stride-docs-release-azure.yml @@ -27,7 +27,7 @@ jobs: - name: Dotnet Setup uses: actions/setup-dotnet@v3 with: - dotnet-version: 6.x + dotnet-version: 8.x # Checkout the Stride Docs repository from the branch that triggered the workflow - name: Checkout Stride Docs diff --git a/.github/workflows/stride-docs-release-fast-track-azure.yml b/.github/workflows/stride-docs-release-fast-track-azure.yml index e256e15c6..bc43340e2 100644 --- a/.github/workflows/stride-docs-release-fast-track-azure.yml +++ b/.github/workflows/stride-docs-release-fast-track-azure.yml @@ -20,7 +20,7 @@ jobs: - name: Dotnet Setup uses: actions/setup-dotnet@v3 with: - dotnet-version: 6.x + dotnet-version: 8.x # Checkout the Stride Docs repository from the branch that triggered the workflow - name: Checkout Stride Docs diff --git a/.github/workflows/stride-docs-staging-azure.yml b/.github/workflows/stride-docs-staging-azure.yml index 891b0cd5e..162b4290d 100644 --- a/.github/workflows/stride-docs-staging-azure.yml +++ b/.github/workflows/stride-docs-staging-azure.yml @@ -27,7 +27,7 @@ jobs: - name: Dotnet Setup uses: actions/setup-dotnet@v3 with: - dotnet-version: 6.x + dotnet-version: 8.x # Checkout the Stride Docs repository from the branch that triggered the workflow - name: Checkout Stride Docs diff --git a/.github/workflows/stride-docs-staging-fast-track-azure.yml b/.github/workflows/stride-docs-staging-fast-track-azure.yml index 7f858be77..f50137612 100644 --- a/.github/workflows/stride-docs-staging-fast-track-azure.yml +++ b/.github/workflows/stride-docs-staging-fast-track-azure.yml @@ -20,7 +20,7 @@ jobs: - name: Dotnet Setup uses: actions/setup-dotnet@v3 with: - dotnet-version: 6.x + dotnet-version: 8.x # Checkout the Stride Docs repository from the branch that triggered the workflow - name: Checkout Stride Docs From e35c630a43fefad360254a0d18b9a876fa36d7c5 Mon Sep 17 00:00:00 2001 From: Vaclav Elias Date: Thu, 16 Nov 2023 18:28:01 +0000 Subject: [PATCH 13/13] feat: Major Version Release Instructions updated --- en/contributors/documentation/index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/en/contributors/documentation/index.md b/en/contributors/documentation/index.md index e45ab2f39..c1dd82b80 100644 --- a/en/contributors/documentation/index.md +++ b/en/contributors/documentation/index.md @@ -32,6 +32,8 @@ Assuming the transition is from version `4.1` to `4.2`, and that the Stride sour - Change `TargetFramework` to the current framework version being used. Ensure to test this step locally 1. Edit `versions.json` - Under `versions`, add the new version `4.2` +1. For GitHub Actions deployment update `*.yml` files in the `.github\workflows\` folder + - `dotnet-version:` Update to the related .NET version The `BuildDocs.ps1` script will manage the deployment to the `4.2` folder while maintaining accessibility to previous versions.