Merge pull request #231 from VaclavElias/master

Update Stride page added
stride3d · Jan 5, 2024 · f577df2 · f577df2
2 parents b6ea306 + 70356bb
commit f577df2
Show file tree

Hide file tree

Showing 5 changed files with 38 additions and 5 deletions.
diff --git a/en/manual/get-started/install-stride.md b/en/manual/get-started/install-stride.md
@@ -16,7 +16,7 @@
 
     > [!Note]
     > Alternatively, you can [download the .NET Framework from the Microsoft Download Center](https://dotnet.microsoft.com/download/dotnet-framework/thank-you/net472-web-installer) and restart the Stride installer.
-	
+    
 4. The **Stride Setup Wizard** opens.
 
      ![Stride Setup Wizard](media/install-stride-setup-wizard.png)
@@ -28,25 +28,25 @@
     ![Stride license agreement window](media/install-stride-license-agreement.png)
 
     Click **Accept**.
-	
+    
 5. The **Stride installation type** window opens.
 
     ![Stride installation type window](media/install-stride-installation-type.png)
-	
+    
     Select an installation type and click **Next**. 
 
 6.  The **Select installation folder** window opens.
 
     ![Select installation folder window](media/install-stride-select-installation-folder.png)
 
     Select a folder to install Stride to and click **Next**.
-	
+    
 7. The **Create application shortcuts** window opens.
 
     ![Create application shortcuts window](media/install-stride-create-application-shortcuts.png)
 
     Choose which shortcuts you want Stride to create, and click **Next**.
-	
+    
 8. The **Ready to Install** window opens.
 
     ![Ready to install window](media/install-stride-ready-to-install.png)

diff --git a/en/manual/get-started/media/update-stride-packages.webp b/en/manual/get-started/media/update-stride-packages.webp
diff --git a/en/manual/get-started/media/update-stride-save-project.webp b/en/manual/get-started/media/update-stride-save-project.webp
diff --git a/en/manual/get-started/update-stride.md b/en/manual/get-started/update-stride.md
@@ -0,0 +1,25 @@
+# Update Stride
+
+<span class="badge text-bg-primary">Beginner</span>
+
+Updating Stride is a straightforward process, but it's important to follow the steps carefully to ensure a seamless transition. Below are the guidelines for updating both the Stride engine and your existing projects.
+
+> [!NOTE]
+> The instructions provided here can be used as a general guide for updating to any new version of Stride.
+
+## Updating Stride
+
+1. **Update Visual Studio 2022:** Ensure that you have the latest version of Visual Studio 2022. This is crucial for compatibility with the latest Stride version. After updating Visual Studio, restart your computer to apply the changes fully.
+1. **Stride Launcher Instructions:** Open the Stride Launcher. Follow the instructions provided to update or install the Visual Studio plugin for Stride. This step is essential for integrating the latest version of Stride with your development environment.
+1. **Restart Again:** After completing the installation or update of the Visual Studio plugin, restart your computer once more. This helps to ensure that all components are correctly loaded and ready for use.
+
+## Updating Your Project
+
+1. **Version Control:** Before proceeding with the update, confirm that your project is under version control with all current changes committed. This provides a safety net, allowing you to revert to the previous state if needed. If you're not using version control, ensure you have a backup of your project.
+1. **Opening the Project:** When you open a project created with an older version of Stride, a dialogue will appear, prompting you to update the project. Make sure to check the option to apply the update to all packages in the solution. Additionally, you can verify later whether all packages have been updated by checking your project files, specifically the `.csproj` files.
+  ![New Project dialog](media/update-stride-packages.webp) *Dialog prompting for project update in Stride.*
+1. **Saving the Project:** After Stride updates the project, it's crucial to save it immediately. This step prevents the project from being in an undefined state and solidifies the changes made during the update.
+  ![New Project dialog](media/update-stride-save-project.webp)
+1. **Rebuild and Reload:** Finally, rebuild the project and reload assemblies. This ensures that all components are up-to-date and properly synchronized with the new version of Stride.
+
+By following these steps, you can smoothly transition to the latest version of Stride, taking full advantage of the new features and improvements it offers. Remember, these procedures are designed to provide a hassle-free update experience and safeguard your project against potential issues.
diff --git a/en/manual/toc.yml b/en/manual/toc.yml
@@ -19,6 +19,8 @@ items:
         href: get-started/install-stride.md
       - name: Visual Studio extension
         href: get-started/visual-studio-extension.md
+      - name: Update Stride
+        href: get-started/update-stride.md
       - name: Launch Stride
         href: get-started/launch-stride.md
       - name: Create a project