docs: Add Information to ctor parameters

chore: Update Launch config, adjusting paths

Author: DevTKSS

.vscode/launch.json

@@ -4,6 +4,13 @@
   // For further information visit https://github.com/OmniSharp/omnisharp-vscode/blob/main/debugger-launchjson.md
   "version": "0.2.0",
   "configurations": [
+    {
+      "name": "Uno Platform Desktop",
+      "type": "Uno",
+      "request": "launch",
+      // any Uno* task will do, this is simply to satisfy vscode requirement when a launch.json is present
+      "preLaunchTask": "build-desktop-MvuxGallery"
+    },
     {
       // Use IntelliSense to find out which attributes exist for C# debugging
       // Use hover for the description of the existing attributes
@@ -13,13 +20,13 @@
       "request": "launch",
       "preLaunchTask": "build-desktop-MvuxGallery",
       // If you have changed target frameworks, make sure to update the program path.
-      "program": "${workspaceFolder}/DevTKSS.Uno.SampleApps.MvuxGallery/bin/Debug/net9.0-desktop/DevTKSS.Uno.SampleApps.MvuxGallery.dll",
+      "program": "${workspaceFolder}/src/DevTKSS.Uno.Samples.MvuxGallery/bin/Debug/net9.0-desktop/DevTKSS.Uno.Samples.MvuxGallery.dll",
       "args": [],
       "launchSettingsProfile": "DevTKSS MvuxGallery (Desktop)",
       "env": {
         "DOTNET_MODIFIABLE_ASSEMBLIES": "debug"
       },
-      "cwd": "${workspaceFolder}/DevTKSS.Uno.SampleApps.MvuxGallery",
+      "cwd": "${workspaceFolder}/src/DevTKSS.Uno.Samples.MvuxGallery",
       // For more information about the 'console' field, see https://aka.ms/VSCode-CS-LaunchJson-Console
       "console": "internalConsole",
       "stopAtEntry": false
@@ -30,13 +37,13 @@
       "request": "launch",
       "preLaunchTask": "build-desktop-XamlNavigationApp",
       // If you have changed target frameworks, make sure to update the program path.
-      "program": "${workspaceFolder}/DevTKSS.Uno.XamlNavigationApp/bin/Debug/net9.0-desktop/DevTKSS.Uno.XamlNavigationApp.dll",
+      "program": "${workspaceFolder}/src/DevTKSS.Uno.XamlNavigationApp/bin/Debug/net9.0-desktop/DevTKSS.Uno.XamlNavigationApp.dll",
       "args": [],
       "launchSettingsProfile": "DevTKSS.Uno.XamlNavigationApp (Desktop)",
       "env": {
         "DOTNET_MODIFIABLE_ASSEMBLIES": "debug"
       },
-      "cwd": "${workspaceFolder}/DevTKSS.Uno.XamlNavigationApp",
+      "cwd": "${workspaceFolder}/src/DevTKSS.Uno.XamlNavigationApp",
       // For more information about the 'console' field, see https://aka.ms/VSCode-CS-LaunchJson-Console
       "console": "internalConsole",
       "stopAtEntry": false
@@ -47,13 +54,13 @@
       "request": "launch",
       "preLaunchTask": "build-desktop-SimpleMemberSelectionApp",
       // If you have changed target frameworks, make sure to update the program path.
-      "program": "${workspaceFolder}/DevTKSS.Uno.SimpleMemberSelectionApp-1/bin/Debug/net9.0-desktop/DevTKSS.Uno.SimpleMemberSelectionApp.dll",
+      "program": "${workspaceFolder}/src/DevTKSS.Uno.SimpleMemberSelectionApp/bin/Debug/net9.0-desktop/DevTKSS.Uno.SimpleMemberSelectionApp.dll",
       "args": [],
       "launchSettingsProfile": "DevTKSS.Uno.SimpleMemberSelectionApp (Desktop)",
       "env": {
         "DOTNET_MODIFIABLE_ASSEMBLIES": "debug"
       },
-      "cwd": "${workspaceFolder}/DevTKSS.Uno.SimpleMemberSelectionApp",
+      "cwd": "${workspaceFolder}/src/DevTKSS.Uno.SimpleMemberSelectionApp",
       // For more information about the 'console' field, see https://aka.ms/VSCode-CS-LaunchJson-Console
       "console": "internalConsole",
       "stopAtEntry": false

.vscode/tasks.json

@@ -7,7 +7,7 @@
       "type": "process",
       "args": [
         "build",
-        "${workspaceFolder}/DevTKSS.Uno.SampleApps.MvuxGallery/DevTKSS.Uno.SampleApps.MvuxGallery.csproj",
+        "${workspaceFolder}/src/DevTKSS.Uno.Samples.MvuxGallery/DevTKSS.Uno.Samples.MvuxGallery.csproj",
         "/property:GenerateFullPaths=true",
         "/property:TargetFramework=net9.0-desktop",
         "/consoleloggerparameters:NoSummary"
@@ -20,7 +20,7 @@
       "type": "process",
       "args": [
         "publish",
-        "${workspaceFolder}/DevTKSS.Uno.SampleApps.MvuxGallery/DevTKSS.Uno.SampleApps.MvuxGallery.csproj",
+        "${workspaceFolder}/src/DevTKSS.Uno.Samples.MvuxGallery/DevTKSS.Uno.Samples.MvuxGallery.csproj",
         "/property:GenerateFullPaths=true",
         "/property:TargetFramework=net9.0-desktop",
         "/consoleloggerparameters:NoSummary"
@@ -33,7 +33,7 @@
       "type": "process",
       "args": [
         "build",
-        "${workspaceFolder}/DevTKSS.Uno.XamlNavigationApp/DevTKSS.Uno.XamlNavigationApp.csproj",
+        "${workspaceFolder}/src/DevTKSS.Uno.XamlNavigationApp/DevTKSS.Uno.XamlNavigationApp.csproj",
         "/property:GenerateFullPaths=true",
         "/property:TargetFramework=net9.0-desktop",
         "/consoleloggerparameters:NoSummary"
@@ -46,7 +46,7 @@
       "type": "process",
       "args": [
         "publish",
-        "${workspaceFolder}/DevTKSS.Uno.XamlNavigationApp/DevTKSS.Uno.XamlNavigationApp.csproj",
+        "${workspaceFolder}/src/DevTKSS.Uno.XamlNavigationApp/DevTKSS.Uno.XamlNavigationApp.csproj",
         "/property:GenerateFullPaths=true",
         "/property:TargetFramework=net9.0-desktop",
         "/consoleloggerparameters:NoSummary"
@@ -59,7 +59,7 @@
       "type": "process",
       "args": [
         "build",
-        "${workspaceFolder}/DevTKSS.Uno.SimpleMemberSelectionApp/DevTKSS.Uno.SimpleMemberSelectionApp.csproj",
+        "${workspaceFolder}/src/DevTKSS.Uno.SimpleMemberSelectionApp/DevTKSS.Uno.SimpleMemberSelectionApp.csproj",
         "/property:GenerateFullPaths=true",
         "/property:TargetFramework=net9.0-desktop",
         "/consoleloggerparameters:NoSummary"
@@ -72,7 +72,7 @@
       "type": "process",
       "args": [
         "publish",
-        "${workspaceFolder}/DevTKSS.Uno.SimpleMemberSelectionApp/DevTKSS.Uno.SimpleMemberSelectionApp.csproj",
+        "${workspaceFolder}/src/DevTKSS.Uno.SimpleMemberSelectionApp/DevTKSS.Uno.SimpleMemberSelectionApp.csproj",
         "/property:GenerateFullPaths=true",
         "/property:TargetFramework=net9.0-desktop",
         "/consoleloggerparameters:NoSummary"

docs/articles/de/HowTo-Adding-New-VM-Class-Record-de.md

@@ -36,6 +36,14 @@ Um ein für Mvux passendes Model zu erstellen:
 
 ![Umbenennen-Klasse-zu-Mvux-Model](../.attachments/renaming-class-to-record-mvux.png)
 
+> [!NOTE]
+> In Mvux werden Models als `record`-Typen definiert, um Unveränderlichkeit und wertbasierte Gleichheit zu nutzen, was für die Zustandsverwaltung in Anwendungen vorteilhaft ist.
+> Die Verwendung von `partial` ist in Mvux Models unerlässlich, um die vom Framework bereitgestellten Code-Generierungsfunktionen zu ermöglichen, wie z.B. automatische Eigenschaftsänderungsbenachrichtigungen und andere Reduzierungen von Boilerplate-Code.
+> [!CAUTION]
+> Genau wie bei regulären C#-Klassen können auch Mvux Models oder Services primäre Konstruktoren haben, die standardmäßig die Parameter als Eigenschaften des Record-Typs erzeugen.
+> Ein potenzieller Nachteil dabei ist, dass ein `INavigator`-Parameter im primären Konstruktor ebenfalls eine Eigenschaft des Models wäre, was normalerweise nicht das ist, was wir als Teil der öffentlichen API unseres Models wollen.
+> Du solltest bevorzugen, diese Service-definierenden Parameter in einem sekundären Konstruktor zu definieren und sie als `private readonly` Felder zu behalten.
+
 ### [Ein ViewModel erstellen](#tab/create-mvvm-viewmodel)
 
 Um ein für Mvvm passendes ViewModel zu erstellen:
@@ -47,3 +55,6 @@ Um ein für Mvvm passendes ViewModel zu erstellen:
 ![Konvertieren-Klasse-zu-ViewModel-Mvvm](../.attachments/converting-class-to-vm-mvvm.png)
 
 ---
+
+> [!NOTE]
+> Du kannst in Uno ViewModels oder Models frei den primären Konstruktor verwenden, beachte jedoch, dass bei Verwendung von `Uno.Extensions.Navigation` keine Parameter im *Page*-Konstruktor erlaubt sind.

docs/articles/de/Navigation/HowTo-UpgradeExistingApp-de.md

@@ -36,6 +36,10 @@ In der Projektdatei, zu erkennen an der Endung `.csproj`, brauchst du dafür neb
 
 > [!TIP]
 > Das `Toolkit` Feature wird nur benötigt, wenn Navigations-Steuerelemente wie `TabBar` oder `DrawerControl` verwendet werden sollen.
+> [!NOTE]
+> Wir benötigen grundsätzlich das `Hosting` Feature und die `DependencyInjection` Funktionalität in unserer Anwendung zu verwenden.
+> Ich sage hier absichtlich "grundsätzlich", da ich bspw. in der hier enthaltenen `MvuxGallery` und `SimpleMemberSelectionApp` Anwendungen das `Hosting` Feature entfernt habe, die App erstellt habe und entgegen der offiziellen Dokumentation ich keine Probleme feststellen konnte.
+> Alle DI Parameter wurden korrekt aufgelöst und ich war weiterhin im stande `ConfigureServices` für die Registrierung von bspw. `KeyedService` in der zugehörigen `App.xaml.cs` Datei mit dem [![Uno.Sdk 6.3.28](https://img.shields.io/badge/Uno.Sdk-6.3.28-blue)](https://www.nuget.org/packages/Uno.Sdk/6.3.28) zu verwenden.
 
 ## App.xaml.cs Konfiguration
 

docs/articles/en/HowTo-Adding-New-VM-Class-Record-en.md

@@ -4,7 +4,7 @@ uid: DevTKSS.Uno.Setup.HowTo-AddingNew-VM-Class-Record.en
 
 ## How To: Create a ViewModel or Model from Classes
 
-In this guide, we will look at how to create a new class element in Visual Studio and then create either a ViewModel or a Model for use in an Uno Platform application with **MVUX**.
+In this guide, we will look at how to create a new class element in Visual Studio and then create either a ViewModel or a Model for use in an Uno Platform application.
 
 For the following steps, let's assume the page that the element to be created belongs to is called **SamplePage.xaml**
 
@@ -16,9 +16,10 @@ For the following steps, let's assume the page that the element to be created be
    ![Adding-new-Item-to-sln](../.attachments/Adding-new-Item-to-sln-en.png)
 
 2. **Create a Class element:**
-   1. Select the **`Class`** element in the list and name it according to the following scheme:
+   1. Select the **`Class`** element in the list and name it according to the naming conventions:
+
+   Your application uses:
 
-   **Your application uses:**
    - **Mvvm:** `SampleViewModel.cs`
    - **Mvux:** `SampleModel.cs`
 
@@ -36,6 +37,14 @@ To create a Model suitable for Mvux:
 
 ![Renaming-Class-to-Mvux-Model](../.attachments/renaming-class-to-record-mvux.png)
 
+> [!NOTE]
+> In Mvux, Models are defined as `record` types to leverage immutability and value-based equality, which are beneficial for state management in applications.
+> Using `partial` is essential in Mvux Models to enable code generation features provided by the framework, such as automatic property change notifications and other boilerplate code reductions.
+> [!CAUTION]
+> Just like in regular C# classes, Mvux Models or Services can also have primary constructors, which will by default produce the parameters as properties of the record type.
+> A potential downside of this is, that a `INavigator` parameter in the primary constructor would also be a property of the Model, which is not what we normally want as part of our Model's public API.
+> You should prefer defining those Service defining parameters in a secondary constructor and keep them as `private readonly` fields.
+
 ### [Create a ViewModel](#tab/create-mvvm-viewmodel)
 
 To create a ViewModel suitable for Mvvm:
@@ -47,3 +56,6 @@ To create a ViewModel suitable for Mvvm:
 ![Converting-Class-to-ViewModel-Mvvm](../.attachments/converting-class-to-vm-mvvm.png)
 
 ---
+
+> [!NOTE]
+> You are free to use the primary constructor in Uno ViewModels or Models, but note that using `Uno.Extensions.Navigation` you can not have parameters in the *page* constructor.

docs/articles/en/Navigation/HowTo-UpgradeExistingApp-en.md

@@ -36,6 +36,10 @@ In the project file, recognizable by the `.csproj` extension, you need the follo
 
 > [!TIP]
 > The `Toolkit` feature is only required to use navigation controls like `TabBar` or `DrawerControl`.
+> [!NOTE]
+> In general we need the `Hosting` feature to use `DependencyInjection` in our app.
+> I say "in general" because, for example, in the included `MvuxGallery` and `SimpleMemberSelectionApp` I removed the `Hosting` feature, created the app, and contrary to the official documentation I couldn't find any problems.
+> All DI parameters were resolved correctly and I was still able to use `ConfigureServices` with `KeyedService` Registration in the corresponding `App.xaml.cs` file with the [![Uno.Sdk 6.3.28](https://img.shields.io/badge/Uno.Sdk-6.3.28-blue)](https://www.nuget.org/packages/Uno.Sdk/6.3.28).
 
 ## App.xaml.cs Configuration