Skip to content
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

Merged
merged 2 commits into from
Nov 30, 2023
Merged

Conversation

parlough
Copy link
Member

@parlough parlough commented Nov 30, 2023

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:

  • 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

@flutter-website-bot
Copy link
Collaborator

Visit the preview URL for this PR (updated for commit 2f8145f):

https://flutter-docs-prod--pr9876-misc-remove-layout-basics-co-3brc0ptu.web.app

@sfshaza2
Copy link
Contributor

So... I LOVE the idea of removing this, but it is a highly viewed page! That's why I didn't remove it already.

Copy link
Contributor

@sfshaza2 sfshaza2 left a 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.)

@sfshaza2 sfshaza2 merged commit aa91bcc into main Nov 30, 2023
9 checks passed
@sfshaza2 sfshaza2 deleted the misc/remove-layout-basics-codelab branch November 30, 2023 15:10
atsansone pushed a commit to atsansone/website that referenced this pull request Dec 11, 2023
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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Explain relationship between Flexible and Expanded widgets on 'Basic Flutter layout concepts' page
4 participants