flutter / website

Flutter documentation web site
https://docs.flutter.dev
Other
2.79k stars 3.2k forks source link

☂️ Update Layout pages #9738

Open atsansone opened 10 months ago

atsansone commented 10 months ago

What information is missing?

Update the Layouts in Flutter and Building Layout pages.

Layouts in Flutter

Building layouts

How would you like us to fix this problem?

Refactor both pages to remove redundancy, update images, and update code.

parlough commented 10 months ago

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 https://github.com/flutter/website/issues/1799#issuecomment-1560160681 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.

atsansone commented 10 months ago

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.