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*

*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]

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 windows' would land on the right page.

Kevin/Filip, WDYT?

--
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 email to misc+uns...@dartlang.org.

[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