dotnet / maui

.NET MAUI is the .NET Multi-platform App UI, a framework for building native device applications spanning mobile, tablet, and desktop.
https://dot.net/maui
MIT License
21.98k stars 1.72k forks source link

.NET MAUI `StackLayout` complicates migration from Xamarin.Forms #13366

Open jonathanpeppers opened 1 year ago

jonathanpeppers commented 1 year ago

Description

This issue is focused around many of the comments on https://github.com/dotnet/maui/issues/6317.

For example:

Frankly, I feel like StackLayouts are very confusing in MAUI and mostly useless, as we have to use Grid in most cases (StackLayout was confusing as hell in XF as well, but for different reasons). https://github.com/dotnet/maui/issues/6317#issuecomment-1247868641

Or another:

At least this change should be properly documented. Multiple issues were closed as "not-a-bug" (e.g. https://github.com/dotnet/maui/issues/5442, https://github.com/dotnet/maui/issues/4115, https://github.com/dotnet/maui/issues/4107, I assume that this one will be closed as well), and in all of them it was mentioned that this changed should be documented. But I haven't found any mentions of that neither in StackLayout documentation, nor in XF migration guide. https://github.com/dotnet/maui/issues/6317#issuecomment-1248178179

We have a doc focused on some of the layout differences:

https://github.com/dotnet/maui/wiki/Xamarin.Forms----MAUI.Controls-Layout-Differences

/cc @davidbritch if you have some ideas on what we could add to official migration docs. Thanks!

Public API Changes

n/a

Intended Use-Case

Ease porting Xamarin.Forms apps to MAUI through documentation (or other ideas).

ghost commented 1 year ago

We've moved this issue to the Backlog milestone. This means that it is not going to be worked on for the coming release. We will reassess the backlog following the current release and consider this item at that time. To learn more about our issue management process and to have better expectation regarding different types of issues you can read our Triage Process.

davidbritch commented 1 year ago

Published yesterday: https://learn.microsoft.com/dotnet/maui/migration/layouts, so I guess this can be closed.

jonathanpeppers commented 1 year ago

@PureWeen the new docs page looks good to me. Did you have an idea here besides docs?