search

flutter / website

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

Remove system requirements from the top of the get started page #10877

Open johnpryan opened 3 months ago

johnpryan commented 3 months ago

When I go to https://docs.flutter.dev/get-started and select a host platform and target platform, the first thing I see are the system requirements:

Screenshot 2024-07-11 at 3 29 56 PM

This seems unnecessary and questionable, are we saying that I can't build a Flutter app if I don't have 8GB of memory on my machine? Even if I'm building a web app? That doesn't seem to be based on any technical requirements for installing and using the Dart or Flutter SDK.

I propose that we remove these system requirements entirely, or at the very least move them to a separate page so that the reader can more quickly get to the important steps they need to do.

sfshaza2 commented 3 months ago

Another good point.

atsansone commented 3 months ago

@johnpryan : These requirements, as we have discussed, are aggregate for the particular path the reader takes. It includes the minimum and recommended requirements for, say, Xcode + Flutter or Xcode + Android Studio + Flutter. These are best put up front before the reader reaches a point where they can't compile. These requirements vary by journey: web requires very little. I'll get confirmation on numbers, but these will probably need to stay in some form.

johnpryan commented 3 months ago

These are best put up front before the reader reaches a point where they can't compile

My point is that these numbers seem arbitrary - Can you point me to situation where having less than 8GB of memory will prevent me from compiling an app? I don't see any such system requirements when I search for XCode system requirements for example.

johnpryan commented 3 months ago

It's better to focus these pages on helping the reader take steps to install their SDK, and if someone wants to check their system requirements we can link them to a page that shows that. But I have a hunch that 99% of readers will skip past this wondering why they needed to scroll down so much just to get to the instructions they were looking for.

atsansone commented 3 months ago

UXR had pointed to a lack of system requirements as an issue. I asked @xster if this looked right, and he agreed that it did. As we have not received reader feedback to the contrary, I'd look to leave this be for now.

johnpryan commented 3 months ago

Again, it's not respectful to our users to put this right at the top of the getting started pages. These pages are super important, since it's the first impression that a Flutter developer sees.

Why are you looking to leave this as is when @sfshaza2 and I agree we should move this somewhere else?