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.

Sign up for GitHub

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

Jump to bottom

Simplify install instructions on macOS install page #2461

Closed
neiljaywarner opened this issue Mar 1, 2019 · 2 comments · Fixed by #9736
Closed

Simplify install instructions on macOS install page #2461

neiljaywarner opened this issue Mar 1, 2019 · 2 comments · Fixed by #9736
Assignees
@atsansone
Labels
a.get-started Relates to the Getting Started section of docs.flutter.dev devos.macOS Relates to developing apps on macOS platform e2-days Effort: < 5 days p2-medium Necessary but not urgent concern. Resolve when possible.

Comments

@neiljaywarner
Copy link

Concrete propositions.

  1. Move system requirements to the bottom of the screen or to a pop-up - make the blue "get sdk" closer to the top
  2. Consider two different audiences - audiences that want hello world to work with no IDE, and audiences that prefer they not use a terminal ever, and make it as easy as possible for those audiences to find what they are looking for - e.g. if you have Intellij and install flutter plugin, how many of the commandline steps will you ever need to do.
  3. Load the flutter version number server side rather than clientside in javascript - then the "loading" button will work without having firewall issues and the commandline can be exactly up to date instead of flutter_macos_vX.X.X-stable.zip

Reason:

  • Flutter is reaching a broad base of users. Some are very comfortable with commandline, and some are not.
  • Flutter is growing so rapidly that the zero-hour experience continues to be important. (Thanks for having that tag)

awesome job with flutter documentation
@sfshaza2 sfshaza2 added p1-high Major but not urgent concern: Resolve in months. Update each month. e2-days Effort: < 5 days labels Mar 2, 2019
@sfshaza2
Copy link
Contributor

sfshaza2 commented Mar 2, 2019

Excellent suggestions.

@atsansone atsansone added a: install devos.macOS Relates to developing apps on macOS platform labels Sep 30, 2022
@atsansone atsansone changed the title 'MacOS install' page issue - Simplify, especially for those not command-line savvy Simplify install instructions on macOS install page May 17, 2023
@atsansone atsansone added a.get-started Relates to the Getting Started section of docs.flutter.dev ltw-triage labels May 17, 2023
@atsansone atsansone self-assigned this Jun 20, 2023
@sfshaza2
Copy link
Contributor

We are planning to overhaul our install/get started instructions. I'm lowering the priority of this issue to P2.

@sfshaza2 sfshaza2 added p2-medium Necessary but not urgent concern. Resolve when possible. and removed p1-high Major but not urgent concern: Resolve in months. Update each month. labels Jun 26, 2023
@atsansone atsansone mentioned this issue Oct 31, 2023
Merged
atsansone added a commit that referenced this issue Dec 21, 2023
@atsansone @sfshaza2
Refactor macOS Getting Started (#9736)
534aa3f 
Total refactor of macOS install.

Fixes #2461
Fixes #2529
Fixes #4995
Fixes #5374
Fixes #7475
Fixes #7647
Fixes #9520

---------

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
Assignees

@atsansone atsansone

Labels
a.get-started Relates to the Getting Started section of docs.flutter.dev devos.macOS Relates to developing apps on macOS platform e2-days Effort: < 5 days p2-medium Necessary but not urgent concern. Resolve when possible.
Projects
None yet
Milestone
No milestone
Development

Successfully merging a pull request may close this issue.

Refactor macOS Getting Started atsansone/website
3 participants
@atsansone @neiljaywarner @sfshaza2