diff --git a/.github/DEVELOPMENT.md b/.github/DEVELOPMENT.md index ad114e16d37c..d4f2a618f03a 100644 --- a/.github/DEVELOPMENT.md +++ b/.github/DEVELOPMENT.md @@ -59,9 +59,13 @@ Before opening the solution in Visual Studio / VS Code you **MUST** build the bu *NOTE*: IntelliSense takes a decent amount of time to fully process your solution. It will eventually work through all the necessary tasks. If you are having IntelliSense issues, usually unloading/reloading the `maui.core` and `maui.controls` projects will resolve. ## What branch should I use? -- main -Always use main no matter what you are working on or where you are hoping your change will get applied. We make sure that main always works against the current stable releases of Visual Studio and the .NET MAUI SDK. Even if you are working on features that will only be released with a future version of .NET. `main` is the only relevant branch for current development. +As a general rule: +- [main](https://github.com/dotnet/maui/tree/main) + +Use ‘main’ for bug fixes that don’t require API changes. For new features and changes to public APIs, you must use the branch of the next .NET version. + +- [net9.0](https://github.com/dotnet/maui/tree/net9.0) ## Repository projects @@ -116,8 +120,10 @@ These are tests used for exercising the UI through accessibility layers to simul ``` ├── Controls +│ ├── samples +│ │ ├── Controls.Sample.UITests │ ├── tests -│ │ ├── UITests +│ │ ├── Controls.AppiumTests ``` ### Unit Test Projects @@ -146,6 +152,8 @@ These tests can be ran using the test explorer in VS, or from command line with dotnet test src/TestUtils/src/Microsoft.Maui.IntegrationTests --logger "console;verbosity=diagnostic" --filter "Name=Build\(%22maui%22,%22net7.0%22,%22Debug%22,False\)" ``` +You can find detailed information about testing in the [Wiki](https://github.com/dotnet/maui/wiki/Testing). + ### Additional Cake Commands #### Clean