-
Notifications
You must be signed in to change notification settings - Fork 3.2k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Remove layout basics codelab #9876
Conversation
Visit the preview URL for this PR (updated for commit 2f8145f): https://flutter-docs-prod--pr9876-misc-remove-layout-basics-co-3brc0ptu.web.app |
So... I LOVE the idea of removing this, but it is a highly viewed page! That's why I didn't remove it already. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
You know what? I just love this idea so I'm a-gonna land it. (I wanted to do this ages ago, but the analytics for the page are pretty good.)
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
We currently have three locations introducing or exploring layout basics in Flutter: Layouts in Flutter, Building layouts tutorial, and this Basic Flutter layout concepts codelab.
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:
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