site-www icon indicating copy to clipboard operation
site-www copied to clipboard

Open Tour Section Code Snippets Should Open in Editor

Open july8six opened this issue 8 years ago • 4 comments

The code snippets should open in an editor so Dart newbies can see exactly how they function. For some learners, it is better if they see how the code works and have the ability to manipulate it rather than being told how it is supposed to work.

july8six avatar Sep 10 '17 18:09 july8six

Agreed. This is about https://www.dartlang.org/guides/language/language-tour, right? It predates DartPad (and, in fact, was published as a book first) but we should update everything to have a DartPad and, perhaps, use print instead of assert.

kwalrath avatar Sep 11 '17 19:09 kwalrath

Yes. It is about the tour.

july8six avatar Sep 11 '17 22:09 july8six

Current thinking is that making everything a DartPad would be rather overwhelming, and that we should instead make the first one an embedded DartPad. After that, we'd use DartPads wherever we want to encourage people to play with the feature.

kwalrath avatar Nov 17 '17 23:11 kwalrath

I tried using a DartPad for the first example in the language tour, but unfortunately there's a lag when you first load the page. Bad experience.

I'll leave this open, since it's something we should continue to keep in mind.

kwalrath avatar Jan 11 '18 19:01 kwalrath

I'm going to close this in favor of https://github.com/dart-lang/site-www/issues/3934 as the Language Tour is meant to be used as a reference and DartPad in its current state won't allow this to be performant if we use it across the page. The alternative would be a proper interactive tour or a more broken up language tour which is also being explored.

Thanks again for the suggestion!

parlough avatar Nov 07 '22 23:11 parlough