flutter / website

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

Request a video intro to key concepts in the Flutter framework #2009

Closed zoechi closed 1 year ago

zoechi commented 5 years ago

@InMatrix commented on Mon Oct 22 2018

In our recent UX studies, we've observed a lot of initial difficulty for developers who came from other frameworks to realize UI programing in Flutter was reactive and UI changes should be done by changing the state of the UI instead of manipulating UI elements directly. Those developers could have benefited from a quick but upfront introduction to the key aspects of the framework, so they don't attempt to apply their existing UI programming knowledge inapplicable to Flutter.

Here is my request: can we turn A Tour of the Flutter Framework into a short video and feature it prominently on our website? It could pair nicely with the more marketing-oriented Introducing Flutter video.

Cc: @RedBrogdon, @galeyang, @jayoung-lee, @Sfshaza


@RedBrogdon commented on Tue Oct 23 2018

Hmm. I'm not sure how short a video could be and still cover all of these topics:

We do have videos in the pipeline for Stateful/Stateless/Inherited and Keys, which will go over some of this content.

If this is your primary concern:

programing in Flutter [is] reactive and UI changes should be done by changing the state of the UI instead of manipulating UI elements directly

We could totally create a short video on that. I've done two recent conference talks about how the widget/element/render trees relate to one another and the motivation behind the way things work. They could probably be distilled into something short and straightforward. Would that help here?


@InMatrix commented on Wed Oct 24 2018

We could totally create a short video on that. I've done two recent conference talks about how the widget/element/render trees relate to one another and the motivation behind the way things work. They could probably be distilled into something short and straightforward. Would that help here?

Yes, totally. It doesn't even need to touch the three trees, IMO. The primary goal of this video is to quickly point out paradigm shifts to developers not familiar with reactive UI frameworks but otherwise proficient in programming, so they can make an informed decision on when they can learn by trial and error and when they do need to pause and read stuff.

The research question, if I may frame it that way, is this: what is the minimum amount of upfront learning required to get an experienced developer started on Flutter and continue with on-demand learning? We can start with something simple and iterate on that using the study sessions scheduled in November. What do you think?

RedBrogdon commented 5 years ago

Our Widgets 101 series is now published, and covers some of this material:

https://www.youtube.com/watch?v=CXedqMlLo7M&list=PLOU2XLYxmsIJyiwUPCou_OVTpRIn_8UMd

Now that Flutter Live is behind us and I have time to think, what other resources are needed here? We've got some guides that touch on the imperative-versus-reactive content:

Are you still looking for a video that would do this as well?

RedBrogdon commented 5 years ago

I'm directing these questions at @InMatrix, I should mention. 😄

InMatrix commented 5 years ago

Thanks for the pointers. The first 2 episodes of Widgets 101 are great intro materials every Flutter dev should go through. I suggest we link/embed them in https://flutter.io/docs#new-to-flutter. @galeyang might have some thoughts on where we show them as well.

https://flutter.io/docs/get-started/flutter-for/declarative

This page is useful for people who come from an imperative UI framework. Where is it linked from?

joeythomaschaske commented 5 years ago

I watched the 101 videos. They were ok. I'm appreciative of them, but the Inherited Widget one could have been better.

At 3:00 he talks about how Inherited Widgets are immutable and doesn't go much deeper into important concepts like wrapping inherited widgets with a stateful container.

I am really struggling with this to be honest. State management is a pain point for me.

I've managed to get a decent architecture setup using Inherited Widgets and custom routing. I really wish this was included in a video for beginners.

I would even put that tutorial guide at about 75% there. It doesn't provide any examples of accessing the state down the tree, or updating it for a matter of fact.

sfshaza2 commented 5 years ago

We have some docs in process, @joeythomaschaske, that should help with this.

InMatrix commented 5 years ago

I think we've added some concept docs/videos, especially https://flutter.dev/docs/get-started/flutter-for/declarative.

Do we want to consider this issue fixed?

efortuna commented 5 years ago

Martin is currently working on a video for the overview I think folks are looking for as described in this bug. But if you want we can close this; we're not using this particular bug to track progress for that.

maguinis commented 5 years ago

I'm working on something along these lines at the moment, as Emily stated.

sfshaza2 commented 5 years ago

We can close this now or wait for Martin's video to go live. I defer to Tao.

efortuna commented 5 years ago

Martin's video is now live! https://www.youtube.com/watch?v=l-YO9CmaSUM Do we want to feature it somewhere on our website? @InMatrix

maguinis commented 5 years ago

Emily! We added it under https://flutter.dev/docs if you scroll down :)

Martin Aguinis | Developer Marketing | Flutter

On Fri, Sep 20, 2019 at 5:30 PM Emily Fortuna notifications@github.com wrote:

Martin's video is now live! https://www.youtube.com/watch?v=l-YO9CmaSUM Do we want to feature it somewhere on our website?

— You are receiving this because you commented. Reply to this email directly, view it on GitHub https://github.com/flutter/website/issues/2009?email_source=notifications&email_token=ACFSNXX7FDLAAMPCLR3QIS3QKVTJ3A5CNFSM4GJVO2EKYY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOD7IGPPQ#issuecomment-533751742, or mute the thread https://github.com/notifications/unsubscribe-auth/ACFSNXRHYAHHVZU4PIVIZBLQKVTJ3ANCNFSM4GJVO2EA .

InMatrix commented 5 years ago

This looks great. Do we have a way to track how many people view this video from that embed?

efortuna commented 5 years ago

Unfortunately no... YouTube doesn't distinguish between views from embedded vs direct. :-(

InMatrix commented 5 years ago

Got it. @galeyang, maybe you could consider using your GA Tag Manager to figure out how many users see the this video and how many clicked on it? Not sure if the latter is possible though. The docs landing page is getting longer, so I'm curious about engagement with the content below the fold.

efortuna commented 5 years ago

Tao, also, actually I just talked to GDS and they do have a way of getting that information. I'm waiting to hear back on stats and how to do that.

InMatrix commented 5 years ago

Great, thanks!

On Mon, Sep 23, 2019 at 10:19 AM Emily Fortuna notifications@github.com wrote:

Tao, also, actually I just talked to GDS and they do have a way of getting that information. I'm waiting to hear back on stats and how to do that.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/flutter/website/issues/2009?email_source=notifications&email_token=AACVGDUL2E4KW4S4X52BTDLQLD3C5A5CNFSM4GJVO2EKYY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOD7LTMZY#issuecomment-534197863, or mute the thread https://github.com/notifications/unsubscribe-auth/AACVGDRHCXP5MWDTZGDHBD3QLD3C5ANCNFSM4GJVO2EA .

galeyang commented 5 years ago

I will also take a look on my side about how many users see/scroll on this page!

atsansone commented 1 year ago

This video has been added. Closing this issue as completed.