[dart-misc] Dart install instructions (proposed change)

[Robert Åkerblom-Andersson]

Hi,

I have been using and following Dart since the really early days, and the I
have never really liked install docs. Today I was browsing the webdev site
and got pleasantly surprised by it's clear and easy Dart install
instructions, I really liked it, but then I realized that the install
instruction at the main site have not changed. Those instructions work, but
they are not great when you compare to nodejs install instructions for
example, or the new webdev instructions for installing Dart.

# dartlang.org install experience
https://www.dartlang.org/install

# webdev.dartlang.org install experience
https://webdev.dartlang.org/guides/get-started#2-install-dart

# nodejs install experience
https://nodejs.org/en/download/

# My proposed new install experience, merging the old dartlang and new
webdev instruction*

<Loading Image...>

*Bare in mind this is concept/idea/mock level, I have made screenshots and
copy pasted in Gimp... Basically my idea is to put the easy to use install
segment from webdev front and center at the main install page, then collect
the existing topics under a single header below saying something like
"Detailed install instructions" or something like that, the manual zip
install and zip file archive could be grouped together with the automated
install instructions in a single list. The old more verbose page you get to
when you click "Install Dart on Linux" for example could be kept, because
they have some good detailed info, but hide them a little bit from new
users needing to quickly install Dart, while at the same time pushing the
easy/fast to use/grasp instruction at the top, 90% or more people only need
that little section and people who want more details can find their way
using the detailed links below. The correct OS tab could also be auto
selected using a minimal Dart script so it always shows the instructions
for the same OS as your browser.

What do you all think about this proposal?

Sincerely, Robert

['Michael Thomsen' via Dart Misc]

I think that is a good idea! But it would be nice if the OS toggle affected
the URL so that searches such as 'dart install window
<https://www.google.com/search?q=dart+install+windows>s' would land on the
right page.

Kevin/Filip, WDYT?

On Sat, Apr 29, 2017 at 2:01 PM, Robert Åkerblom-Andersson <

Post by Robert Åkerblom-Andersson
Hi,
I have been using and following Dart since the really early days, and the
I have never really liked install docs. Today I was browsing the webdev
site and got pleasantly surprised by it's clear and easy Dart install
instructions, I really liked it, but then I realized that the install
instruction at the main site have not changed. Those instructions work, but
they are not great when you compare to nodejs install instructions for
example, or the new webdev instructions for installing Dart.
# dartlang.org install experience
https://www.dartlang.org/install
# webdev.dartlang.org install experience
https://webdev.dartlang.org/guides/get-started#2-install-dart
# nodejs install experience
https://nodejs.org/en/download/
# My proposed new install experience, merging the old dartlang and new
webdev instruction*
<https://lh3.googleusercontent.com/-6jILtLFX8fY/WQR8mDO8zEI/AAAAAAAAA6s/r8TeFk0REvI75CwDNfsPqR02RbIP7jH3gCLcB/s1600/dart_install.png>
*Bare in mind this is concept/idea/mock level, I have made screenshots and
copy pasted in Gimp... Basically my idea is to put the easy to use install
segment from webdev front and center at the main install page, then collect
the existing topics under a single header below saying something like
"Detailed install instructions" or something like that, the manual zip
install and zip file archive could be grouped together with the automated
install instructions in a single list. The old more verbose page you get to
when you click "Install Dart on Linux" for example could be kept, because
they have some good detailed info, but hide them a little bit from new
users needing to quickly install Dart, while at the same time pushing the
easy/fast to use/grasp instruction at the top, 90% or more people only need
that little section and people who want more details can find their way
using the detailed links below. The correct OS tab could also be auto
selected using a minimal Dart script so it always shows the instructions
for the same OS as your browser.
What do you all think about this proposal?
Sincerely, Robert
--
For other discussions, see https://groups.google.com/a/dartlang.org/
For HOWTO questions, visit http://stackoverflow.com/tags/dart
To file a bug report or feature request, go to http://www.dartbug.com/new
---
You received this message because you are subscribed to the Google Groups
"Dart Misc" group.
To unsubscribe from this group and stop receiving emails from it, send an

[Robert Åkerblom-Andersson]

Glad to hear that Michael. =)

The url could be changed without reloads using pushState. If the same route
would serve "/install" and "/install/{os}" then you could check the url in
Dart and add or act on the OS part when needed. The current routes like
"/install/windows" would need a new route if we would do it like that. The
webdev page seem to always show me the Linux instructions so there might be
an OS check there already.

- https://api.dartlang.org/stable/1.23.0/dart-html/History/pushState.html
- http://caniuse.com/#feat=history

Post by 'Michael Thomsen' via Dart Misc
I think that is a good idea! But it would be nice if the OS toggle
affected the URL so that searches such as 'dart install window
<https://www.google.com/search?q=dart+install+windows>s' would land on
the right page.
Kevin/Filip, WDYT?
On Sat, Apr 29, 2017 at 2:01 PM, Robert Åkerblom-Andersson <

Post by Robert Åkerblom-Andersson
Hi,
I have been using and following Dart since the really early days, and the
I have never really liked install docs. Today I was browsing the webdev
site and got pleasantly surprised by it's clear and easy Dart install
instructions, I really liked it, but then I realized that the install
instruction at the main site have not changed. Those instructions work, but
they are not great when you compare to nodejs install instructions for
example, or the new webdev instructions for installing Dart.
# dartlang.org install experience
https://www.dartlang.org/install
# webdev.dartlang.org install experience
https://webdev.dartlang.org/guides/get-started#2-install-dart
# nodejs install experience
https://nodejs.org/en/download/
# My proposed new install experience, merging the old dartlang and new
webdev instruction*
<https://lh3.googleusercontent.com/-6jILtLFX8fY/WQR8mDO8zEI/AAAAAAAAA6s/r8TeFk0REvI75CwDNfsPqR02RbIP7jH3gCLcB/s1600/dart_install.png>
*Bare in mind this is concept/idea/mock level, I have made screenshots
and copy pasted in Gimp... Basically my idea is to put the easy to use
install segment from webdev front and center at the main install page, then
collect the existing topics under a single header below saying something
like "Detailed install instructions" or something like that, the manual zip
install and zip file archive could be grouped together with the automated
install instructions in a single list. The old more verbose page you get to
when you click "Install Dart on Linux" for example could be kept, because
they have some good detailed info, but hide them a little bit from new
users needing to quickly install Dart, while at the same time pushing the
easy/fast to use/grasp instruction at the top, 90% or more people only need
that little section and people who want more details can find their way
using the detailed links below. The correct OS tab could also be auto
selected using a minimal Dart script so it always shows the instructions
for the same OS as your browser.
What do you all think about this proposal?
Sincerely, Robert
--
For other discussions, see https://groups.google.com/a/dartlang.org/
For HOWTO questions, visit http://stackoverflow.com/tags/dart
To file a bug report or feature request, go to http://www.dartbug.com/new
---
You received this message because you are subscribed to the Google Groups
"Dart Misc" group.
To unsubscribe from this group and stop receiving emails from it, send an