Merge pull request unoplatform#15249 from unoplatform/dev/jela/docs

docs: Adjust rider known issues
ramezgerges · Jan 30, 2024 · cb4efc8 · cb4efc8
2 parents e00c13c + e7e4ae1
commit cb4efc8
Show file tree

Hide file tree

Showing 4 changed files with 15 additions and 1 deletion.
diff --git a/doc/articles/common-issues-rider.md b/doc/articles/common-issues-rider.md
@@ -0,0 +1,7 @@
+---
+uid: Uno.UI.CommonIssues.rider
+---
+
+# Issues related to Rider
+
+You can view the [list of known issues in Rider's bug tracker](https://github.com/unoplatform/uno/issues/15226).
diff --git a/doc/articles/common-issues.md b/doc/articles/common-issues.md
@@ -17,6 +17,7 @@ More troubleshooting information is available [in this section](xref:Uno.Feature
 - [All Development Environments](xref:Uno.UI.CommonIssues.AllIDEs)
 - [Visual Studio 2022 for Windows](xref:Uno.UI.CommonIssues.vs2022)
 - [VS Code](xref:Uno.UI.CommonIssues.vscode)
+- [Rider](xref:Uno.UI.CommonIssues.rider)
 
 ## Platforms
 

diff --git a/doc/articles/create-an-app-vs2022.md b/doc/articles/create-an-app-vs2022.md
@@ -15,7 +15,7 @@ To create an Uno Platform app:
     ![Visual Studio - Get started - Selecting `create a new project` option](Assets/tutorial01/newproject1.PNG)  
     ![Visual Studio - Create a new project - Selecting `Uno Platform App` option](Assets/tutorial01/newproject2.PNG)
 
-1. Configure your new project by providing a project name and a location, then click the **Create** button
+1. Configure your new project by providing a project name and a location, check the "**Place solution and project in the same directory**" option, then click the **Create** button
 
     ![Visual Studio - Configure project name and location](Assets/tutorial01/configure-new-unoplatform-app.PNG)
 

diff --git a/doc/articles/migrating-from-previous-releases.md b/doc/articles/migrating-from-previous-releases.md
@@ -6,6 +6,12 @@ uid: Uno.Development.MigratingFromPreviousReleases
 
 This article details the migration steps required to migrate from one version to the next when breaking changes are being introduced.
 
+## Uno Platform 5.1
+
+Uno Platform 5.1 does not contain breaking changes that require attention when upgrading.
+
+This version however introduces the MSBuild Uno.SDK, which provides support for smaller project files and better Visual Studio integration. Using the Uno.Sdk is entirely optional and previous projects templates are fully supported. If you want to migrate to Uno.Sdk based projects, you can follow the [Migrating Projects to Uno.Sdk](xref:Uno.Development.MigratingToUnoSdk) guide.
+
 ## Uno Platform 5.0
 
 Uno Platform 5.0 contains binary-breaking changes in order to further align our API surface with the Windows App SDK. Most of these changes are binary-breaking changes but do not introduce behavior changes.