☂️ Update Layout pages #9738
Comments
atsansone
added
p2-medium
|
This was one of the largest pieces of follow-up work we discussed as part the IA work. I thought I filed this issue already months ago, but I can't seem to find it... Maybe it was a draft? This is one of the initial and core concepts to Flutter, so not only should we consolidate these pages and update the code/images, but they likely need to be completely reviewed and overhauled. It might just make sense to write a whole new page. There are new widgets, new best practices, new platforms, new lots of things since these docs were written. I'm not completely sure though, that's why I suggested (and still do) starting with #1799 (comment) and collecting feedback from both Flutter team members and other developers using Flutter on what we currently cover, what we are not yet covering, what part of layouts were/are hard for them, what best practices have developed over the years that should be accounted for, etc. |
|
I'm going to start with a code and test approach for the tutorial. That each of these pages have a tutorial is another issue. |
We currently have three locations introducing or exploring layout basics in Flutter: [Layouts in Flutter](https://docs.flutter.dev/ui/layout), [Building layouts tutorial](https://docs.flutter.dev/ui/layout/tutorial), and this [Basic Flutter layout concepts codelab](https://docs.flutter.dev/codelabs/layout-basics). We need a better and consolidated layout story. I think rather than hobbling along with these three pieces of outdated and overlapping material, we need to start from a cleaner place where users don't have so many unnecessary choices. As a first step, I think we need to just remove one of these, and I think this codelab is a good choice to start with for a few reasons: - The DartPad technology (testing, solutions, etc) it relies on is going away soon - @johnpryan This page is the main user of DartPad testing functionality on the Flutter site. - The many embedded DartPads result in a slow site loading experience and an essential non-functional mobile experience - The code on the page does not have excerpts and has been outdated, broken, or filled with warnings for surprising amounts of time multiple times in the past - The formatting of the page and text is inconsistent with the rest of the site - With little teaching around each layout type, the API docs are likely a better resource and often have runnable snippets This type of learning experience should eventually be replaced by a consolidated interactive step-by-step in-browser learning experience for intro Flutter concepts. Contributes to #9738 Closes #6300
We currently have three locations introducing or exploring layout basics in Flutter: [Layouts in Flutter](https://docs.flutter.dev/ui/layout), [Building layouts tutorial](https://docs.flutter.dev/ui/layout/tutorial), and this [Basic Flutter layout concepts codelab](https://docs.flutter.dev/codelabs/layout-basics). We need a better and consolidated layout story. I think rather than hobbling along with these three pieces of outdated and overlapping material, we need to start from a cleaner place where users don't have so many unnecessary choices. As a first step, I think we need to just remove one of these, and I think this codelab is a good choice to start with for a few reasons: - The DartPad technology (testing, solutions, etc) it relies on is going away soon - @johnpryan This page is the main user of DartPad testing functionality on the Flutter site. - The many embedded DartPads result in a slow site loading experience and an essential non-functional mobile experience - The code on the page does not have excerpts and has been outdated, broken, or filled with warnings for surprising amounts of time multiple times in the past - The formatting of the page and text is inconsistent with the rest of the site - With little teaching around each layout type, the API docs are likely a better resource and often have runnable snippets This type of learning experience should eventually be replaced by a consolidated interactive step-by-step in-browser learning experience for intro Flutter concepts. Contributes to flutter#9738 Closes flutter#6300
What information is missing?
Update the Layouts in Flutter and Building Layout pages.
Layouts in Flutter
Building layouts
Paddinginstead ofContainerwhen it makes sense in 'Building layouts' #9118How would you like us to fix this problem?
Refactor both pages to remove redundancy, update images, and update code.
The text was updated successfully, but these errors were encountered: