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

Write V2 'Layout' first week experience page #10775

Closed
8 of 9 tasks
ericwindmill opened this issue Jun 21, 2024 · 0 comments
Closed
8 of 9 tasks

Write V2 'Layout' first week experience page #10775

ericwindmill opened this issue Jun 21, 2024 · 0 comments
Assignees
Labels
a.fwe Relates to the first week experience e2-days Effort: < 5 days from.page-issue Reported in a reader-filed concern p2-medium Necessary but not urgent concern. Resolve when possible.

Comments

@ericwindmill
Copy link
Contributor

ericwindmill commented Jun 21, 2024

Page URL

https://docs.flutter.dev/get-started/fwe/layout

Page source

No response

Describe the problem

The current page is a list a links, which was the goal for V1 of FWE. The goal of V2 is to have more of the concepts are explained on the page directly.

Expected fix

  • Explain constraints and box types on the page, including necessary diagrams and code examples.
  • Show an example of using single-child layout widgets on the page, including diagrams and text that explains the example.
  • Show an example of using flex widgets (rows and columns) on the page, including diagrams and text that explains the example.
    • Explain alignment, sizing and using Expanded within Flex widgets
  • Explain unbound constraints bug, and use it as an example to explain devtools and debugging
  • Show an example of using scrolling widgets on the page, including diagrams and text that explains the example.
  • Show an example of the builder pattern on the page, including diagrams and text that explains the example.
  • For all above explanations, remove outbound links to redundant resources

Additional context

No response

I would like to fix this problem.

  • I will try and fix this problem on docs.flutter.dev.
@ericwindmill ericwindmill added from.page-issue Reported in a reader-filed concern a.fwe Relates to the first week experience labels Jun 21, 2024
@ericwindmill ericwindmill self-assigned this Jun 21, 2024
@sfshaza2 sfshaza2 added p2-medium Necessary but not urgent concern. Resolve when possible. e2-days Effort: < 5 days labels Jun 21, 2024
ericwindmill added a commit that referenced this issue Jul 17, 2024
_Description of what this PR is changing or adding, and why:_
- Updates FWE layout page with expanded information on the page,
including code examples and diagrams.
- Removes many of the links to other resources.
- Moves remaining links to the 'additional resources' section.

_Issues fixed by this PR (if any):_ #10775 

## Presubmit checklist

- [x] This PR is marked as draft with an explanation if not meant to
land until a future stable release.
- [x] This PR doesn’t contain automatically generated corrections
(Grammarly or similar).
- [x] This PR follows the [Google Developer Documentation Style
Guidelines](https://developers.google.com/style) — for example, it
doesn’t use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first person).
- [x] This PR uses [semantic line
breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks)
of 80 characters or fewer.

---------

Co-authored-by: Shams Zakhour (ignore Sfshaza) <44418985+sfshaza2@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
a.fwe Relates to the first week experience e2-days Effort: < 5 days from.page-issue Reported in a reader-filed concern p2-medium Necessary but not urgent concern. Resolve when possible.
Projects
None yet
Development

No branches or pull requests

2 participants