website icon indicating copy to clipboard operation
website copied to clipboard

☂️ Update Layout pages

Open atsansone opened this issue 2 years ago • 2 comments

What information is missing?

Update the Layouts in Flutter and Building Layout pages.

  • [ ] #9066

Layouts in Flutter

  • [ ] #4130
  • [x] #2719
  • [x] #2528

Building layouts

  • [ ] #3056
  • [x] #2108
  • [x] #1799
  • [x] #9118
  • [x] #8922

How would you like us to fix this problem?

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

atsansone avatar Oct 31 '23 20:10 atsansone

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.

parlough avatar Oct 31 '23 20:10 parlough

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.

atsansone avatar Nov 01 '23 17:11 atsansone